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Visual Development Environment For 


WATCOM VX'Rexx is an easy to use visual development 
environment for creating applications that leverage the 
capabilities of OS/2 2.x and exploit the Presentation Manager 
graphical user interface. VX'Rexx combines a project 
management facility, visual designer and an interactive source- 
level debugger to deliver a very approachable and highly 
productive visual development environment. 


Design Applications 

Visually Create rich graphical 
applications quickly and easily using 
the visual design environment. With 
the visual designer, you can 
graphically create Presentation 
Manager interface objects, quickly 
customize their properties, and 
easily attach Rexx procedures using 
powerful drag-and-drop 
programming techniques. 


Integrated Development 
Environment Build, test and 

debug your application without 
leaving the development 
environment. Then package your 
application as an EXE file or PM 
macro for royalty-free redistribution. 
The power of the integrated 
development environment and 
debugger can also be used with your 
existing Rexx applications. 


Powerful Open 
Environment Enjoy the 

simplicity of event-driven 
programming together with the 
global editing capabilities 
essential for professional project 
management. WATCOM 
VX»Rexx is open and extensible 
through IBM’s object oriented 
System Object Model (SOM) 
technology. You can access all 
standard Rexx API’s including 
DB2/2, because VX'Rexx is 
based on the OS/2 2.x standard 
system Rexx. 


Highlights 


► Easy to use visual development environment 

► Create and modify objects dynamically at 
both edit and run time 

► Powerful project management facility 

► Advanced interactive source-level debugger 

► Package your applications as EXE files or 
PM macros 

► Access to standard Rexx API’s including 
DB2/2 

► System Object Model (SOM) based object 
manager 


► Drag-and-drop programming 

► Support for multi-threaded applications 

► Include OS/2 style help and hints in your 
applications 

► Supports SAA CUA’91 objects 

► Integrated console window support for 
existing Rexx programs 

► Royalty-free run-time 

► Multiple modeless window support 

► Create PM macros for applications 
supporting Rexx as a macro language 
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OS/2 Rexx 


WATCOM International 

415 Phillip Street, Waterloo, Ontario, Canada, N2L 3X2 
Phone: (519) 886-3700 Fax: (519) 747-4971 

‘Prices and specification are subject to change without nolice Price does not include freight and taxes where applicable. Prices 
quoted in US dollars. WATCOM, the Lightning Device, and VX-ftExx are trademarks of WATCOM International Corporation, Other 
trademarks are the properties of their respective owners. © Copyright 1993 WATCOM International Corporation. 


Interactive Debugging 

If an error occurs at run-time, 
VX*Rexx will display a traceback 
pinpointing the source line where 
the error occurred. A simple click 
of the mouse will return you to the 
source edit window to correct the 
error. The built-in interattive 
source-level debugger lets you set 
breakpoints, step through code 
and watch variables to track down 
complex problems. 


Suggested Retail: $199* 
Call Toll Free 

1 - 800 - 265-4555 

WATCOM 


Build Professional 
Applications 

WATCOM VX-Rexx allows 
you to leverage key OS/2 features 
to create professional applications. 

Build applications that dynamically 
create and modify CUA’91 screen 
objects at both edit and run-time, 
and include OS/2 style help and hints. 

Create Multi-Threaded 

Applications Every VX-Rexx 
application contains multiple threads. 

One thread remains responsive to user 
input while others continue processing. 

In addition, VX-Rexx provides the 
ability for advanced applications to easily 
use additional threads. 
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VX-Rexx: 


The integrated visual 
solution builder for OS/2 2.x. 
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44 We were told it was impossible 
to develop a client/server application 
without extensive retraining. 

Then we talked to Micro Focus. ^ 



Mountain Fuel Supply? a division of Questar? is a utility company 
supplying natural gas to 750,000 customers across Utah p Wyoming, Idaho 
and Colorado. The company's success is largely driven by its implicit belief 
that the customer is number one. 

Yet, IT also plays its part in that success: client/server architectures and 
graphical user interfaces (GUIs) have helped Mountain Fuel Supply move 
applications and information closer to the customers and the employees. All 
of which has resulted in an augmented level of service being offered to 
customers. 

When Larry Lowder, one of Questar s Systems Architects, set out to 
build the client/server architecture for Mountain Fuel Supply, he needed 
solutions, not skepticism. For the first project, a cashiering system, he 
needed to link workstations with OS/2® to the DB2* database on the host, 
running GIGS" 1 

“We were faced with having to spend up to two years retraining our 


COBOL programmers in C and API calls. Then we discovered Micro Focus 
Dialog System? It allowed us to build the client functionality we required, 
and re-engineer the existing mainframe application as a server.” 

“Within a week, mainframe programmers were producing GUI screens 
for COBOL. Within 90 days we had delivered the system. Now we're not 
only coming in under budget, but also way ahead of schedule ” 

As Mountain Fuel Supply discovered, the Micro Focus solution lets 
you make a productive transition to client/server without sacrificing any of 
the resources you've worked so hard to build. 

When the world's leading corporations demand “A Better Way of 
Programming?" they turn to Micro Focus, For a brochure on putting the 
Micro Focus Client/Server Solution to work for you, call 800-872-6265, 

MICRO FOCUS 

Micro Focus Inc. 2465 East Bayshore Road, Palo Alto, CA 94303. Tel. (415) 856 416L 


Micro Focus « * reg&itiifd iradfmwlt and DulogSysero *nd "A Better Way of Frogramiwng 1 ' m Trademarks of Mlere Foot*, Inc All whet tradeJMfki He property of tfwit raspealv* «Ymp#iiie* 

GSA Contract Number GS00K93AGS6403. 
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SourceLink v2.0 

by One Up Corporation 

SourceLink, the ultimate 32-blt programming 
development tool, combines the functionality of 
hyperlink source ctxle access, a fully-functional 
editor and extensive file manipulation utilities into 
one very powerful toolset. Now you can find code, 
change code, spawn compiles and hyperlink 
directly to the source of error quickly and efficient 
ly. Features point & click source code navigation 
and automatic generation of function call trees. 



List: $299 


Ours: $239 


FAXitura #: 6005-0003 




Window Washer v2.0 

by One Up Corporation 

The latest version of the best-selling 32-bit 
screen saver for OS/2, with full system pass¬ 
word security and the most complete moni¬ 
tor burn in protection available today, 
Version 2.0 features many exciting animated 
effects, digital video and audio (plays CD’s. 
MIDI or WAV fifes with program effects). Also 
utilises Tir. GIF. BMP. & PCX backgrounds. 

List: $40 Outs: $35 

FAXcetim #: 6005-0001 





Open Shutter vl.ll 

by One Up Corporation 

Our easy-to-use screen capture process 
allows you to select any rectangular area, 
window, or entire desktop, and capture 
with a single user-defined keystroke or 
mouse click. Rotate, change colors, 
stretch/com press and then preview your 

modifications. Output to printer, clipboard, or soft copy In a variety of 
formats (BMP. ICO, 11FF, GIF, IMG, metafile, MacPaint), 

List: $70 Ours: $59 

FAXcettro #: 6005-0002 



WATCOM VX-REXX 

by WATCOM Int'l Corp. 

WATCOM VX“REXX is an easy to use visual devel ■ 
opulent environment for creating applications that 
leverage the capabilities of OS/2 2,x and exploit 
the Presentation Manager graphical user interface, 
VX*REXX combines a project management facility, 
visual designer and an Interactive source-level 
debugger to deliver a very approachable and highly 
productive visual development environment. 

List: $199 Ours: $99* 



FAXcettra #: 1683-0016 


’Pricing valid while supplies last. 
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Introducing the Lotus 
SmartSuite 32-Bit 
Bundle for OS/2! 

by Lotus Development Corp. 

Lotus' new SmartSuite for OS/2 Is die only com¬ 
plete 32-bit solution for OS/2 desktops. For a lim¬ 
ited time, when you buy SmartSuite for OS/2 or a 
SmartSuite for OS/2 Upgrade, youll get OS/2 2.1 
FREE, Act now to take advantage of this special 
Introductory offer, while supplies last! 


Upgrade: 


List: $795 Ours: $599 

List: $595 Ours: $319 


FA Xcetera#: 4000-0027 



Objects +-k 

Da la base Class Library 


SQL Objects++™ 
Database Class Library 

by Graphical Software 
Interfaces. Inc. 


SQL Objects*Database Class Library Is a 
powerful collection of object-oriented database classes that provide direct 
access to SQL and non-SQL databases. Each class is fully optimized to pro¬ 
vide fast access to your data. No other access library is designed to fully 
utilize your OS/2 environment. 

List: $699 Ours: $499 

FAXit’itn? #: 1010-2601 


Ami Pro 3.0 for OS/2 

by Lotus Development Corp. 

OS/2 users now have a native, 32-bit version of the 
award-winning Ami Pro 3,0 for Windows, Written from 
the ground up for OS/2, the new version of Ami Pro 
provides the highest level of word processing, net¬ 
working and development power among OS/2 

word processors 



List: $495 Ours: $369 

Upgrade: List: $129 Ours: $ 99 

FAXmmj #: 4000-0011 



GUARANTEED BEST PRICES!<Call for details) 
To order call: 800-445-7899 
Corporate (CORSOFT): BOO 422*650?' 

FAX: 908 389-9227 
International: 908 389-9228 
Customer Service: 389*9229 
Programmer's Paradise Italia: 

39 2 480 16053 

Far more Informal ion on the products 
featured on this page call— 

FAX.ifm®: (201) 762-1378 




1163 Shrewsbury Avenue 
Shrewsbury, NJ 07702 

* All prices are subject to chcmoe without notice. 
•Call lor details an return policy and snipping charges 
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BY DICK CONKLIN 


n Editor's 
Comments 


Proffit, Programming, and Products 


O S/2 Developer continues to grow, adapting 
to the changing needs of our readers* As we 
begin another new year, we're adding three 
new features that I think you'll like* During OS/2 '$ 
early years, we focused on the needs of independent 
software developers, as new commercial applications 
and tools took center stage. As more businesses 
downsize from mainframes to networked PCs, more 
corporate developers join the ranks of our readers. 
Sure, commercial ISVs and corporate programmers 
face many of the same technical challenges, but there 
are some important differences. The typical Fortune 
500 programming department doesn't sell its appli¬ 
cations through retail channels; it nevertheless must 
"sell" and satisfy very demanding in-house cusr 
tomers. ISVs creating standalone 05/2 products may 
not have to write client/server code, but they should 
be aware of the environment of their corporate users. 

In this issue, we welcome back Brian Proffit, who 
graced these pages with a Software Tools column not 
long ago. Brian's new Corporate Study column will 
bring you real world examples of corporate OS/2 
projects, from decision-making to user acceptance. 

Dave Reich is also no stranger. Dave has written 
for OS/2 Developer, published books on OS/2 pro¬ 
gramming, and provided technical support to devel¬ 
opers since Day One. His OS/2 Programming Insid¬ 
er column will deliver tips, techniques, hints, and 
examples only an OS/2 insider knows. Welcome! 

BUYERS GUIDE 

Not long ago we introduced a new Product Watch 
section, featuring news of new software tools, utili¬ 


ties, and support for developers. In this issue we add 
a Buyers Guide—a listing of products related to the 
theme of this issue—OS/2 database 
development. This section is a "keep¬ 
er" you'll want to refer to later. Thanks 
to our new managing editor, Kelly 
Leighton, and editorial assistant, 

Andrea Pucky, for making it happen— 
glad to have you with us! 

WELL WHAT DO YOU THINK? 

Thanks to all of you who send us e- 
mail and participate in the OS/2 Developer section on 
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CompuServe (forum OS2DF2). Your comments help 
us make the magazine better serve your needs, If you 
haven't written lately, drop us a line. If you have an 
idea for an article, pass it along. Better yet, if you 
have advice or a programming trick for your fellow 
OS/2 developers, write a short article about it. You 
don't need an English degree, just a knowledge of 
the subject* Well meet you more than halfway, A 
short fax (415/905-2234) will start the process. 



OS/2 Developer, VoL 6, No. 1, January/February 1994 

Subscription information: US.; One year (six issues), $39.95, Canada, Mexico, and international surface mail, add $16 per year for postage. Canadian GST no, 124513185. Inter* 
national air mail, add $30 per year for postage. Foreign orders must be accompanied by payments in US. funds. For new orders and customer service, call (800) WANT-GS2 
(800-926-8672) or (708) 647-5960 (fax: 708-647-0537). IBM employees and branch office customers can subscribe to OS/2 Developer through IBM Mechanics burg's Systems 
Library Services (SLSS) using OS/2 Developer *s order number: G362-0001. POSTMASTER: Please send address changes to OS/2 Developer, P.O. Box 1079, Skokie, IL 60076-8079, 
Allow eight weeks for subscriptions to begin* OS/2 Developer (ISSN 1073-0729) is published bimonthly by Miller Freeman Inc., 600 Harrison Street, San Francisco, CA 94107, 
(415)905-2200. Application to mail at second class postage rates is pending at San Francisco, CA and additional mailing offices, 

OS/2 Developer has applied for BP A membership. 

© Copyright 1994 by Miller Freeman Inc. PRINTED IN THE U.S. A. 


JANt/ARY/FEBRUARY 1 9 $ 4 


5 















lull 



Corporate Study 

Just as they can write better programs by looking at sample code, developers.can better design those applica¬ 
tions by looking at real world problems and solutions. Our new Corporate, Study column will examine the prob¬ 
lems faced by organizations and how OS/2 products and tools helped to solve tftem. By BRIAN proffit 
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Judges Find a New Way to 
Client/Serve Papers 



Brian Proffit 


MM n immense amount of information is 
MgM processed behind the scenes in any county 
B ■ court system. Unlike a corporation, howev¬ 
er, the users change frequently, bringing their own 
data processing preferences with them. Using OS/2 
2,1 and CICS is one way to simplify the data 
exchange process and downsize it at the same time, 

Frank Fitzsimmons faced this problem as direc¬ 
tor of Judicial Information Systems for Florida's 
17th Judicial Circuit in Broward County. Broward, 
which contains Ft Lauderdale, is the second- 
largest county with the second-largest judicial cir¬ 
cuit in Florida. The judicial system (judges, state 
attorney, public defender, and sheriff) is composed 
of elected officials. 

According to Fitzsimmons, "As parochial as they 
are, individuals count things differently, and there¬ 
fore they have their own system. The adjudication of 
cases by a judge is counted differently than possibly 
[by] the state attorney or the clerk of the court. There 
are some standard reporting methods that we are 
responsible for at the state level, but internally, 
everyone does accounting slightly differently." 

His organization ties hundreds of laptops 
together with numerous application servers and 
mainframe systems—whose data he doesn't 
own—into an integrated information system. 


SIMILAR PROBLEMS 

There are many similarities between the needs of 
Broward Judicial Information Systems (JIS) and a 
private sector corporation, "Government is a busi¬ 
ness, but people don't look at it that way," Fitzsim¬ 
mons says, "With the 65 judges, I have 65 individ¬ 


ual members of the Board, and the Court Admin¬ 
istrator is the Chairman of the Board. It's my job to 
support their requirements and needs." 

The information pyramid has three levels, with 
back-office systems at the bottom, management 
systems in the middle, and executive-decision sys¬ 
tems at the top. For JIS, the back-office systems 
correspond to the civil and criminal case files han¬ 
dled by the clerk of the court. The middle includes 
jury management, probation management, and 
family-court management; much of this data is on 
IBM mainframes owned by other organizations. 
At the top are the programs that pull the data 
together into a meaningful form for the 65 judges 
and their judicial assistants. 

When he first arrived, Fitzsimmons found an 
environment not suited for handling these needs. 
"When we first got here, they were using three dif¬ 
ferent brands of PCs, all 8088 level, with 3270 PCs 
at the top end. Seven years ago, w r e put together a 
plan to migrate from where they were, which was 
nowhere, to where we'll be by the end of 1993." 

Fitzsimmons's progress was limited by the 
tools available at the time, but technology caught 
up with his needs. "At the time, we put in DIS- 
OSS, which wasn't even called OfficeVision yet 
We wrote a common front end on the 3090 host 
with CICS to give access to all the host-based 
applications and access to mail. Throughout the 
process, we have used mail to tie things together/' 

As he began to upgrade the desktop to PS/2 
Model 55SXs, Fitzsimmons searched for an operating 
system. "We were in an environment where we had 
more than one application running simultaneously," 
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LEARN OBJECTS FAST. 

DEVELOP 10* FASTER. 



Want to 
know the 
fastest way to 
learn objects - 
even for C++ 
developers? The 
experts recommend 
Smalltalk/]/, the technology 
that's 100% pure objects. 



Smalltalk/V to the rescue. Simply 

by enabling large programs to be 
built from pretested software | 
objects, it can provide tenfold 
leaps in programmer productivity 
and software quality. Perhaps 
more important, Smalltalk pro¬ 
grams deal in terms programmers/ 
can understand 


“”“«r 


FASTER, EASIER LEARNING. 


With C++, you have to 
accomplish two huge tasks: 
learning object class libraries, 
and learning new C++ language 
syntax. Plus C++ is a hybrid of C 
with added object extensions. So 
odds are, you'll find yourself con¬ 
stantly falling back on familiar 
procedural methods and losing 
the benefit of objects. 

Smalltalk/V has a simpler, 
more approachable language_ 
that lets you focus on 
learning objects instead 
of a new syntax. That's 
why thousands of profes¬ 
sional programmers have 
found Smalltalk/V to be 
the fastest, most efficient 
way to learn the object- 
oriented paradigm. In fact, 



C++ will make 
more sense once 
you learn OOP 
with Smalltalk/V. 

But we think you'll want to con¬ 
tinue using Smalltalk/V for your 
application development. 


DEVELOP lOx FASTER. 


Greg Voss of Windows Tech 
Journal says: "It’s not an exag¬ 
geration to say that most applica¬ 
tions of significant size can be 
built ten times faster in 
Smalltalk/V than in C or C++. ” 
Gen Kiyooka of Windows Tech 
Journal agrees: "Nothing on 

earth can match the effi¬ 
ciency and productivity 
of experienced 
Smalltalk/V program¬ 
mers. Nothing." And 
Business Week reminds 
us that some Wall Street 
firms now get their 
"computer models of 




SMALLTALKS. 100% PURE OBJECTS. 


brand-new finan¬ 
cial instruments 
done in days, not 
months.” 


EASY TO USE. 


Here’s how SmalltalkA/ 
cuts development 
time by as much as 
90%. •Easy-to-use 
integrated environ¬ 
ment. •Incremental compilation 
shows immediate results of code 
changes. •Over 350 well-tested 
reusable classes built-in and 
100’s more available. •Class 
browsers and object inspectors 
to examine code and isolate 
errors. •Automatic memory man¬ 
agement to eliminate memory 
related bugs. • Easy access to 
3GL languages. •Integrated 
graphic debugger. •Available on 
Windows 3.1, Windows NT, OS/2 
and Macintosh. 

So if you want to learn objects 
fast - and develop lOx faster - 
punch this line of code into your 
telephone: (800) 531-2344 
Department 706. We’ll send you 
complete information. 


DIGITALK 
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Figure 1 . The 17th Judicial Circuit Court of Florida information network 


Fitzsimmons says. For example, a judge 
or judicial assistant might often use two 
separate CICS regions and a word proces¬ 
sor. They need cut-and-paste capabilities 
between the host sessions and word 
processor. They may also have multiple 
documents open, plus other Personal 
Information Manager (PIM) functions. 

To support those needs, Fitzsimmons 
took an early look at OS/2. "We had the 
first version of OS/2 [1.0] in here, and we 
had a lot of problems. We went through 
beta releases and tested them. It was an 
extremely difficult year. We brought 
Windows in and looked at it. At the time, 
in the 286 and 386 days, Windows looked 
pretty good. It was an advancement." 

Next, they simplified and standard¬ 
ized data access for the desktop sys¬ 
tems. Like many organizations, JIS 
opted for Ethernet. "Our initial entry 
into a LAN-based system was a jury 
management system we did in Dataflex 
on the Ethernet," says Fitzsimmons. 
"We programmed it and redistributed 
it to several circuits throughout Flori¬ 
da, with the help of the state court sys¬ 


tem. Immediately, we found that the 
Ethernet didn't have a lot of integrity. If 
you move a PC, the network comes 
crashing down." Changing the network 
at that point wasn't an easy task. As 
many MIS organizations must do battle 
with corporate offices to make changes, 
Fitzsimmons had to fight the county. He 
eventually received permission to shift 
from unshielded twisted pair to Type 1 
twisted pair cable and token ring. 

There was more to Fitzsimmons's 
seven-year plan. There were still many 
problems as a result of the data coming 
from several different places. "We need¬ 
ed to get to the data from the LAN, no 
matter if it was on a server, midrange, or 
mainframe. If a juror comes in late and 
the information is still up on the host, we 
need to be able to get that data down to 
the LAN right away." 

JIS didn't own the data, however, and 
couldn't ask the county or state to 
change its way of doing business. So, 
court officials were running in batch 
mode at that point, shipping files from 
the host, working with the Dataflex pro¬ 


gram on the LAN during the day, and 
batching updates back to the host. 

On top of that, Windows wasn’t all 
they had hoped for. "We were plagued 
by the dreaded unrecoverable applica¬ 
tion errors [UAEs]," Fitzsimmons 
reports. "Picture the system I described 
earlier: A judicial assistant is running 
two different host sessions with Attach- 
mate to feed into a WordPerfect docu¬ 
ment and is in a hurry to get informa¬ 
tion to a judge. Suddenly, the assistant 
receives a UAE and has to reboot the 
system, restart the host sessions, and 
lose who-knows-how-much of the doc¬ 
ument. The first time that happened, 
the complaints began. The first time it 
happened while the judge was looking 
over the judicial assistant's shoulder, 
the situation became intolerable." 

REASSESS AND UPGRADE 

Fitzsimmons then began another round 
of hardware upgrades, moving to PS/2 
56SLCs, and decided it was time to give 
OS/2 another look. "Our IBM account 
team came in here and convinced us to 
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They’re all here. All the tools, tips and techniques you need 
to send your OS/2® development rocketing up the charts. 
Brought to you by the original artists: IBM’s own OS/2 develop¬ 
ment team. 

Join The Developer Connection for OS/27 
and you’ll receive the most timely and extensive 
information available to the OS/2 community. 
Four times a year, you’ll get a CD packed with the 
latest productivity tools, utilities and sample programs 
from IBM and others. A powerful browser and 
user interface let you locate any topic instantly in our com¬ 
prehensive technical library. 

Each CD includes the latest releases of smashes like 
‘The Developer’s Toolkit for OS/2,” “Multimedia Presenta¬ 
tion Manager/2 Toolkit,” and “Pen for OS/2 
Toolkit.” Plus, you also get pre-release 
versions of many IBM products, operating sys¬ 
tems, internal development tools, product demos, 
bit maps—you name it. 

But wait, there’s more. You also receive 


The Developer Connection News , our newsletter filled with 
information about the latest OS/2 developments, new products, 
a Q&A column and much more. Plus, you get access to the Developer 
Connection forum on CompuServe?* where you can talk directly to 
the experts. 

And here’s music to your ears: Buy a year’s subscription to The 
Developer Connection for OS/2 
before February 15,1994 for only 
$199 and receive a free copy of the 
Clear & Simple® hit “Performance 
2.1,” a tuning kit for OS/2. Call 
1 800 6DEVCON today, and start 
producing some hits of your own. 


: Buy a year’s subscription to The 

hits. 


Operate at a higher level? 


•CompuServe membership is required. IBM and OS/2 are registered trademarks and The Developer Connection tor OS/2 
and "Operate at a higher lever are trademarks of International Business Machines Corporation- CompuServe is a 
trademark of CompuServe Incorporated Clear & Simple is a registered trademark of Clear & Simple. Inc. ©1993 IBM Corp 




















take a long hard look at CICS OS/2 to 
downsize applications on a midrange 
system we wanted to get rid of* When 
version ZO went golden and all the debug 
code was removed, it was a lot faster, but 
it was still pretty slow. It was more stable 
than Windows, though. One of the 
biggest factors was CICS OS/2, It allowed 
us to downsize some applications and 
streamline our access to host data for 
other applications. Today you'd call it 
client/server, but back then we just called 
it a distributed system, where we had 
data on both the host and the LAN, and 
we wanted to merge them to make the 
divisions more effective. Today, if that 
juror comes in late, with CICS OS/2 and 
distributed transaction processing, we can 
get that data to the LAN right away/' 

The same, distributed transaction 
technology solved another problem; 
monitoring probation. The probation- 
client tracking system is even more sig¬ 
nificant, because it is a revenue program. 
Clients pay a fee for the cost of supervi¬ 
sion, so there is a lot of accounting in 
addition to the client tracking. If a person 
is adjudicated guilty and given proba¬ 
tion, he or she needs to report to the pro¬ 
bation department within 24 hours. 


we need. That's a fully multithreaded 
application, and it took the combination 
of CICS and OS/2 to make it possible/' 

A PLATFORM FOR THE FUTURE 

Now that the platform is in place, 
Fitzsimmons will exploit it further. 
"We're migrating from OfficeVi- 
sion/MVS down to Lotus ccmail, By 
the end of 1993, all judges and their 
judicial assistants will be running 05/2 
2.1 with Communications Manager/2 
access to the host and all the host-based 
applications, plus WordPerfect, ccmail 
(we're using IBM LAN Gateway/2 to 
interface between ccmail and OfficeVi- 
sion), and an appointment calendar, 
probably Lotus Organizer." 

Fitzsimmons believes there is a mes¬ 
sage to software developers in their 
choice of ccmail and Organizer. "We 
looked at WordPerfect Office for three 
months before moving to ccmail. Office 
provides better integration, but the ker¬ 
nel is still 16-bit and doesn't offer the 
performance we need. The 32-bit speed 
of ccmail makes up for holes In the inte¬ 
gration with Lotus Organizer." Speed is 
important; the system processes around 
400,000 pieces of e-mail per month. 


Government is a business, but 
HH people don't look at it that way. 


The records for clients are on a main¬ 
frame. To bypass the county's bureaucra¬ 
cy for adding or changing applications 
using the CICS system, Fitzsimmons 
again used Dataflex and CICS OS/2 to 
get to the data, Fitzsimmons says, "If a 
client hands you documents, the operator 
can run a distributed CICS transaction 
against the record on the host and bring 
it down.-We can also now run (from a PC 
on the LAN) a report to list all the people 
that were supposed to show up. We can 
tickle records to find out if there is a vio¬ 
lation of the probation terms. All of this 
was done manually, and paperwork 
used to fall through the cracks. Now, 
with CICS OS/2, we can put information 
in, bring it down, ship it out, and do 
whatever type of data entry or update 


Having the network in place allows 
Fitzsimmons to provide additional ser¬ 
vices. "We have legal research CD-ROM 
systems running on the network. We're 
also implementing access to a remote 
paging facility and fax modems." 

Fitzsimmons still needs to react to 
decisions made by the county and 
state, "There is going to be greater 
tracking of domestic violence cases, 
probably with an AS/400 application. 
Accessing that system from our net¬ 
work will further expand our range. 
We have a solid platform in token ring, 
we have a solid multifunctional oper¬ 
ating system in OS/2 on the desktop, 
and with LAN Server and Communi¬ 
cations Manager, we can access what¬ 
ever we plug into the network from 


wherever we are with a GUI interface. 

"Our next step is to extend our range 
outside the court and allow document 
transfer, probably with ccmail Remote, to 
mailboxes in the local legal community. 
We want to give them the ability to 
exchange documents with the court, and 
we will be looking at adding imaging of 
documents to help. The good news is the 
platform to support this is in place. We've 
come full circle, from essentially nothing 
to extending beyond the courthouse and 
judicial system. This will make the judges 
and court system more responsible and 
effective in disseminating information," 

ANALYZING THE RESULTS 

Fitzsimmons glows about the changes at 
Broward County Judicial Information 
Systems, "The Service Pak for OS/2 2.0 
fixed a lot of our problems. Version 2.1, 
especially the performance improvement, 
is super. We installed version 2.1 for gen¬ 
eral distribution as soon as it came out. 
We took old DOS 3270 PCs with a hodge¬ 
podge of software and replaced them 
with 56SLCs running OS/2 2.1, Commu¬ 
nications Manager/2, and WordPerfect 
for Windows on a LAN server network. 
We went from a bicycle to a Cadillac. Key 
is that we had no problems with installa¬ 
tion, implementation, or training." 

Fitzsimmons believes that was par¬ 
tially due to the way they conducted the 
training, focusing on user benefits rather 
than operating platform features. "When 
we install, we do some basic training—a 
mouse, icons, and so on. These people 
have never dealt with these things. We 
show users how easy it is to pull several 
things together at once. They understand 
that it is easy to use, attractive, and most 
importantly, that they don't have to 
reboot the system frequently/' 

Brian Proffit has been in the computing indus¬ 
try for 20 years. He was part of IBM's OS/2 
team but left to become the director of PC 
Week's Corporate LabsHe is now president 
of Visionary Research Proffit is the author of 
OS/2 Application Development Tools, and 
OS/2 Inside & Out. He has written for OS/2 
Magazine, PC Week, and Programmer's Par¬ 
adise. He can be reached on CompuServe at 
75300,1466. 
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easiest-to-use C++ development system for world-class 
OS/2 applications. 

Borland C++ for OS/2 is 
a complete application devel¬ 
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tools with the industrial-strength power of OS/2, 
so building C and C++ OS/2 applications is faster 
and easier than ever before. Borland’s highly integrated 
graphical environment and visual tools raise pro¬ 
ductivity to a whole new level. The new, integrated 
Turbo Debugger GX finds bugs fast. And you can 
take full 
advantage of 
the full power 
of OS/2 with 
32-bit code 
generation, 

pre-emptive multitasking and state-of-the-art 
optimizations. 

To help speed your development along, Borland 
C++ gives you access to the largest resources of 
OS/2 libraries, controls and other add-ins. So if you re 
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today—and sec what develops. To order or to find out 
more about OS/2 2.1 or Borland C++ for OS/2, call 
1 800 3-LBM-OS2. In Canada, call 1 800 465-7999. 

Operate at a higher level. 


Borland C 


IBM and OS/2 are registered trademarks and “Operate at a higher level' is a trademark, of International 
Business Machines Corporation Borland is a registered trademark of Borland International, Inc 
©1993 IBM Corp. 






























Programming Insider 


0S/2's dynamic link libraries IDLLs) can be a big advantage—if they are used correctly. In this issue, our new 
Programming Insider column explains the tradeoffs, pitfalls, and benefits of DLLs. BY DAVID reich 


Ins and Outs of Dynamic Link 
Libraries 


ynamic link libraries (DLLs) are an integral 
part of OS/2. Since OS/2 1.0, DLLs have 
been used to share code and reduce the sys¬ 
tem working set. While people are now accustomed 
to writing DLLs, 1 often see the concept of a DLL and 
how it should be used taken to the point of absurdity. 
I have seen applications shipped with hundreds 
* of DLL tiles. Others have one huge (as in the 3 

megabyte range) 1)1 Land a relatively small .HXH file. 
Still others have DLLs that are brought into memory 
^ j A F ^ when the application loads; a DLL stays there until 
A IMA, L the application terminates and is never called. 

There may be good reasons for these application 

development design decisions. Having a large num- 
Davtd Reich * . & ° ° , . 

ber of DLLs isn t necessarily wrong. However, devel¬ 
opers are often unsure of why they are using DLLs, 
and many do not install or implement them as effi¬ 
ciently as possible. 

WHAT IS A DLL? 

A DLL is a file that contains a group of functions 
callable by many different processes. It is not an exe¬ 
cutable entity unto itself, yet after it is loaded it 
resides in memory like standard executable code. 
Architecturally, a DLL file is a cross between an exe¬ 
cutable program file and a set of functions, like the 
static C runtime libraries. The biggest difference is 
that a DLL does not have a nain() routine. The DLL 
loads into memory and lives there. 

A DLL is loaded by the loader as a result of a call 
from a thread of a process. This is done directly via 
DosLoadModule or indirectly by a program importing 
an entry point in the DLL. The system wall set up the 
DLL in memory, which is then accessible to any 



process in the system. It provides common routines 
to anyone in the system without forcing each appli¬ 
cation to have copies of the common routines built 
into each .EXE file. This improves performance and 
saves working set memory. 

WHY USE A DLL? 

Why should you put code in a DLL? DLLs reduce 
the size of the final, executable program and make 
code shareable. However, the primary functions of a 
DLL are to share routines among several processes, 
strategically delay code loading, and control the in¬ 
memory life of the code. 

Used optimally, DLLs make your application 
perform better and increase the efficiency of the 
user's computer. Used incorrectly, they can slow 
down your application considerably as well as hurt 
overall system performance. Let's look at how each 
primary function fits into the scheme of things. 

Sharing. First, a DLL is the tool for sharing code 
among processes or programs. Since DLLs are just a 
set of functions or library routines, a client process 
needs to know the parameter list for each of the 
functions it intends to call. 

When writing a program, you simply call the 
functions in the DLLs by their name, and the DLL 
automatically links to the program. When you link a 
DLL to the application, a special external reference 
record is placed where the function call is. These ref¬ 
erences are also listed in the executable file's header. 

Once the compilation is complete and the object 
file is generated, there is still an external reference to 
this function. In the link phase of application devel¬ 
opment, the DLL's LIB file is used to resolve the 
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function reference. Also, the reference in 
the IB file of a DLL is not the code itself 
as it would be with, for instance, the sta¬ 
tically-linked C runtime libraries, ft is 
only a special external reference record 
pointing to the name of a DLL file and 
an ordinal (the number of the function 
within the DLL) within that file. 

Loading. When a program loads, the 
loader reads through the .EXE header 
and finds all DLL references. If a DLL file 
is already loaded, the program resolves 
the references to it. If the DLL is not 
loaded, the program loads it and resolves 
the references. This usage scheme has its 
good points and bad points. 

The scheme is good, because the 
application only needs to call the func¬ 
tions in the DLL by name and pass their 
parameters as if they were internal to the 
application. The application does not 
care where the functions are located. In 
this scheme, your programs can access 
important routines regardless of where 
they physically reside. 

The drawback is that the DLLs get 
loaded when the application loads. If 
the functions referenced are never 
called, you loaded DLLs to resolve 
external references you never make. 
This wastes overhead. Also, for every 
external reference, the resolution, once 
made, is stored in application-swap¬ 
pable memory, increasing the working 
set of the application. 

Another way to use functions in DLLs 
is to call the function by address rather 
than by name. This method saves the 
overhead of the resolutions at load time 
and saves application memory by delay¬ 
ing the loading of code until it is actually 
needed. This is done by calling Dosload- 
Module to load the DLL and obtain a han¬ 
dle to it, and DosGetProcAddr to obtain tine 
address of the function. Once again, this 
method has strengths and weaknesses. 

The strength is that you don't load 
code you aren't going to use. You also 
save space with respect to all the header 
resolutions you might otherwise gener¬ 
ate. The weakness is that you will take a 
performance hit by loading the DLLs 
during application execution rather than 
having them ready when needed. Load¬ 
ing strategy is one of the most misunder¬ 


stood points about DLLs. 

Memory , Say you want to avoid the 
performance hit of loading the DLL dur¬ 
ing application execution. You want the 
library already loaded and ready. You 
want to call the function by name, and 
the header resolutions done. You don't 
care about the memory overhead of the 
resolutions, but want the DLL ready the 
instant you need it. You loaded the DLL 
when the program started. 

Users will always use more memory 
than they have in the system. Therefore, 
the application will likely be running in a 
memory-constrained environment. Since 
memory is constrained and the user has 
not used the function yet, its page is like¬ 
ly to be paged out, so it has to be 
reloaded. Now the DLL has been loaded 
twice so the application can use it once. 
A solution is to call the function by 
address and only load it once. 

SHRINKING YOUR EXECUTA BLE 

An example of using DLLs for an unin¬ 
tended purpose is to make the exe¬ 
cutable file smaller. All too often, I've 
seen DLLs implemented because the 
developer thought performance would 
be better if the .EXE file was smaller. 

AH code is loaded in 4K pages and 
accessed as needed. Whether the code 
resides in a DLL or in the executable 
does not matter. The pieces of the exe¬ 
cutable code are loaded as needed, so it 
is unnecessary to put code in a DLL just 
to make the .EXE smaller. By strategical¬ 
ly placing functions in pages in the .EXE 
file, you will better overall system per¬ 
formance than if you just place functions 
in a DLL. 

Another good reason for using DLLs 
is for Workplace Shell object classes. 
Because the current model of the OS/2 
Workplace Shell is a single process, all 
objects must be accessible from the 
Workplace process. As such, object class¬ 
es that you write will Live in DLLs. 

Use DLLs to create system exten¬ 
sions, strategically delay loading of 
code, and allow code sharing among 
processes. Workplace object class DLLs 
are also a system extension. Avoid 
DLLs that exist simply to make exe¬ 
cutable files smaller. 


WHERE DO YOU PLACE DLLS? 

There is no correct answer. There are 
architectural considerations when plac¬ 
ing DLLs on a user's system and how (or 
if) to modify the LIBPATH when doing so. 
Since there is no one, best way to decide 
where to put them, understanding the 
choices based on the DLL's intended 
purpose will help you guide your users 
in placing these files correctly. 

In the most generic case, a DLL is 
specific to an application or series of 
applications. Although a DLL's primary 
goal is to enable the sharing of code 
among processes, the majority of DLL 
implementations by applications are 
restricted to the single application or a 
series of related applications (as opposed 
to someone publishing a common set of 
system-extension routines, which is a 
great use for DLLs). 

When the DLLs have such a specific 
and focused use, it's best to place them in 
the same directory as the executable file 
or files. Then, when installing the pro¬ 
gram and creating the program reference 
object for the Workplace Shell, you set the 
Working Directory setting to point to the 
directory containing the executable file. 

Starting with OS/2 2.0, the operating 
system installation program places a .; 
at the start of LBPATH. Then, whenever the 
system is searched for DLLs and an 
explicit path is not specified, the system 
looks in the current working directory 
for the DLLs before looking anywhere 
else. If the working directory for your 
program is set to the directory where the 
DLLs live, they will be found instantly. 

It is a bad idea to put your program s 
directory in the front of the LBPATH. First, 
you will be moving the pieces of the 
operating system further back in the LB- 
PATH, slowing down the system. Your pro¬ 
gram's directory will be searched before 
operating system DLL files will be found. 
If every application did this, the operat¬ 
ing system's as well as other applications' 
DLL path entries would be pushed back, 
causing a performance nightmare. 

In the most general case, let the sys¬ 
tem find your DLLs through the . ; in 
the LBPATH, with you setting the working 
directory in the program reference 
object. You win, because the DLLs are 
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QH found quickly, and the user wins. 
Ml because you are not dangerously rear- 
| ranging items in the LIBPATH. 

Workplace shell class DLLs . Placing 
DLLs on the disk for Workplace Shell 
classes is an interesting and often reli¬ 
gious discussion topic. There is no stan¬ 
dard for it, and the architecture of the 
system places strict requirements on the 
functions in these DLLs. 

When a new object class is created, it 
is registered with the Workplace Shell, 
which creates the appropriate entries in 
the operating system initialization files 
and desktop. The Workplace Shell needs 
the name of the DLL that contains the 
definition of the new object. If no path is 
specified, the LIB PATH is searched. 

Let's say that you want to place the 
DLL with the executable files. This is not 
a bad idea, and it goes along well with 
the previous discussion. However, if the 
user remakes Eli files, your class's regis¬ 
tration will be lost. This is not a prob¬ 
lem-just reregister it 

Lets say you have excellent foresight; 
when the program for the application 
runs, it checks to see if your class is regis¬ 
tered, and if it's not, the application rereg¬ 
isters it However, you don't know where 
the user put your DLL. You could assume 
that your DLL is in the same place as 
your program's executable or you could 
query to see where the executable lives. 

Another solution is to put the DLL for 
the object class into a directory that 
always exists in the LIBPATH. The working 
directory won't cut it this time because 
you need to tell the shell where to find it, 
and the shell process' working directory 
is not the same as your executable's 
working directory. You could look for 
the boot drive and put it into, say, 
\0S2\DLL on that drive. But if the user 
reinstalls or moves the operating system 
to another drive without your DLL, 
you re back where you started. 

You could also put your directory in 
the LIBPATH. (If you do decide to do this, 
remember to add it to the end of the LB- 
PATH.) This is not the best solution, either. 
Some users don't let application- 
installation programs change the CON¬ 
FIG.SYS file. We let the program tell us 
what it wants, then add the things we 


need and work around the rest. 

For example, if a program tries to add 
something to the LIB PATH, 1 set the work¬ 
ing directory for the program-reference 
object to whatever the program wants to 
add to the LBPATH, rather than let it mod¬ 
ify my LIBPATH. Although this works in a 
general case, it won't work for Work¬ 
place Shell object class DLLs. 

By understanding how DLLs work, 
you can make the solution fit your exact 
needs. I prefer the first option: keep the 
DLL with the executable and pass the 
path to WinRegisterObjectQass. When the 
.EXE starts, make sure that the class is 
registered. If it isn't, register it. 

Be aware that users may want to 
move your application to another drive 
or directory. If they do, the class DLL 
will not be found. Document that when 
moving the application to another drive, 
the user should reinstall it. This is also 
an important consideration for programs 
installed on LAN drives. Consider plac¬ 
ing a copy of the class DLL on the client 
workstations. 

You can also combine the first and sec¬ 
ond options. Copy the DLL to, say, 
\0S2\DLL. When the program starts, make 
sure the class is registered and the DLL is 
in \0S2\0LL on the boot drive {by using 
DosQueryPathlnfo). If they aren’t, take actions 
to fix the class registration. Deregister the 
class (even if it was not registered), copy 
the DLL from the application directory to 
\QS2\DIL, and register the class again. 

The requirements of the current 
design of the Workplace Shell, combined 
with how DLLs are searched for and the 
things users do to the system, make 
choosing a location for your DLL very 
difficult. Use your knowledge of how 
DLLs work to make the best choice for 
your situation. 

System-extension DLLs . System-exten¬ 
sion DLLs need to be available to the 
operating system at all times, especially 
during system initialization. As such, 
they should always be in a directory 
accessible via LIBPATH. Since the processes 
accessing these classes are the system's 
processes, it is not feasible to put them in 
a working-directory entry. 

Adding an entry to the LIBPATH is not 
the best solution; if you add it to the end. 


all other directories have to be searched 
before the system-extension DLL is 
found. If you put the search entry at the 
beginning of LIBPATH, that directory is 
searched in all DLL searches, 

I suggest you install system-extension 
DLLs in a directory that already exists in 
the LIBPATH, such as \DS2\DLL on the boot 
drive. The drawback: if the user reinstalls 
the operating system; in that case, your 
DLL will be erased. Then again, it should 
be ob vious to the user that if he or she 
reinstalls the operating system, any sys¬ 
tem extensions must also be reinstalled. 

SHOULD YOU EVEN USE A DLL? 

DLLs used for their intended purpose are 
excellent tools. You can share code 
among programs and create system 
extensions, such as Workplace Shell 
classes, and make them part of the sys¬ 
tem. However, there are quite a few con¬ 
siderations to take into account when 
using DLLs. The first is whether you 
should use one at all. 

Do you want to make your .EXE 
smaller? Or do you want to have your 
code accessible from multiple programs? 
Once you decide to use a DLL, look care¬ 
fully at the purpose of the functions con¬ 
tained in it Are they Workplace Shell 
object-class implementations? Are they 
just common routines for use in multiple 
programs? Are they system extensions? 
Depending on the answers, you have dif¬ 
ferent considerations when deriding 
where to put them and how to modify 
the system configuration to use them. 

Used appropriately, DLLs can make 
your application efficient and powerful. 
Used for the wrong reasons, they can 
slow down the users' system consider¬ 
ably. The choice is yours, 

David Reich has been with the OS/2 devel¬ 
opment team in Boca Raton t Fla. since 1987 . 
He has traveled the world giving seminars 
on OS/2 to users and developers, has written 
numerous articles for OS/2 Developer maga¬ 
zine, and is the author of Designing OS/2 
Applications (Wiley and Sons Inc, 19931 
Reich has an M S, from the State University 
of New York at Albany. He can be reached 
on CompuServe at 76711,632 or on Internet 
at speedracer@vnet ibm. com . 
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n May’s high lechnology marketplace, you hear a lol of stories about proprietary 4GLs tor client/server 
application development. Stories that lure you... that make 4GLs sound flexible, fast and open. 

Beware the paradox: how can 4GLs be open when someone else holds the key? 
Using client/server 4GL tools means opening Pandora’s box of proprietary languages, vendor lock-in, and runtimes up to 16 
limes slower. With surprises like these, trusting your business critical applications to 4GLs should scare you half to death. 


KASE WORKS' 


/\ /\ Zji Zji Enabling Client/Server Strategies 


Fact. Not fantasy 
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m Database 

This article describes the process for building DB2/2 database applications for OS/2 and how programmers 
can quickly develop application programs to meet their needs. BY LUCIANO pedron 



Exploring the DB2/2 Applica¬ 
tion-Development Process 


r o manipulate data stored in relational data¬ 
base management systems (RDBMSs), 
application programmers need special 
tools and utilities. DB2 for OS/2 (DB2/2) 1.0 pro¬ 
vides a third-generation language, application- 
development solution for building applications 
for DOS, Windows, and OS/2 clients. 

This article describes the process for building 
DB2/2 database applications for OS/2 and how 
programmers can quickly develop application 
programs to meet their needs. 

APPLICATION PROGRAM ELEMENTS 

Several basic elements are unique to DB2/2 appli¬ 
cation programs. 


strcpy ( STATEMENT, 

"UPDATE staff SET job = 'Qerk' where job = 'Mgr'"); 

EXEC SQL EXECUTE IMMEDIATE :STATEMENT; 
if (SQLCQDE !- 0) 

printf("\nUpdate Error: SQLCODE = Xid 11 , SQLCOOE); 

Figure 1 . Embedding SQL statements 



Luciano Pedron 



Figure 2. Declaring host variables. 


Embedded SQL Statements. SQL is embedded in 
a host-language source file. The SQL statements 
provide the database interface, while the host lan¬ 
guage provides the remaining support needed for 
the application to execute. Figure 1 shows embed¬ 
ded SQL statements. 

SQL statements placed in an application pro¬ 
gram are not host-language-specific In compiled 
host languages (C, COBOL, or FORTRAN) the 
precompiler converts embedded SQL into specif¬ 
ic, language statements the host language can 
process. These specific, language statements are 
DB2/2 run-time API calls. 

In REXX, SQL statements are passed to DB2/2 
at run time through the SQLEIEC API, REXX appli¬ 
cations are not precompiled. For additional infor¬ 
mation about SQL, consult the DB2/2 SQL Refer¬ 
ence Manual. 

Host Variables. Host variables are variables ref¬ 
erenced by embedded, SQL statements. They 
transmit data between DB2/2 and the application. 
When you use a host variable in a SQL statement, 
you prefix the host variable with a colon (:). 
When you use a host variable in a host language, 
you omit the colon. 

Host variables are declared in compiled host 
languages and are delimited by BEGIN DECLARE SEC¬ 
TION and END DECLARE SECTION statements. These 
statements enable the precompiler to find the dec¬ 
larations. See Figure 2 for declared host variables. 

DB2/2 APIs. DB2/2 provides configuration, 
environment, utility, and additional APIs to 
include in application programs. For example, 
Figure 3 shows a call to the DB2/2 INSTALL SIGNAL 
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Figure 3, Calling DB2/2 routines 


EXEC SQL INCLUDE SQLCA; 

Figure 4. Including the SQLCA structure 



Figure £ Including the SQLENV include file 

HANDLER API (calling this API installs a signal han¬ 
dler to process a user-generated Ctrl+Break or 
Ctrl+C signal). 

Two sets of DB2/2 APIs are provided for com¬ 
piled languages: a set for C programs (SQLmxx) 
and a generic set (SQLGxxxx) for COBOL and FOR¬ 
TRAN. There is no functional difference between 
the two sets; the generic set is provided for host 
languages that do not use null-terminated strings. 

In REXX, DB2/2 APIs are not called directly. 
Instead, command-line versions of the APIs are 
passed as arguments to the SQLDBS APT For addi¬ 
tional information about APIs, consult the DB2/2 
Programming Reference Manual . 

Data Structures , An application uses several 
data structures when communicating with 
DB2/2. The most commonly used data structure 
is the SQL Communication Area (SQLCA), DB2/2 
transmits return codes through it to the database 
application- DB2/2 updates the SQLCA after most 
API calls and each time a SQL statement is 
processed. 

The statement in Figure 4 causes the precom¬ 
piler to insert into the host variable the definition 
of the SQLCA structure and a structure occurrence 
called sqlca. One method of defining and allocat¬ 
ing an SQLCA structure is by embedding the SQL 
statement shown in Figure 4 in an application. 

Include Files , Include files, provided with 
DB2/2, contain the necessary definitions of APIs, 
constants, data structures, and macros required 
by applications written in compiled host lan¬ 
guages. They must be included in an application 
to use the defined DB2/2 APIs, Figure 5 shows 


tinclude <stdio.h> 
tinclude <string.h> 
findude <stdlib.h> 
linclude <sqlenv.h> 

(i) 

EXEC SQL INCLUDE SQLCA; 

int (twin(void) 

{ 

EXEC SQL BEGIN DECLARE SECTION; 

(2) 

char STATEMENT [80] = " 

EXEC SQL END DECLARE SECTION; 

(3) 

SQL.API.RC rc = 0; 

printf( "\nSample C program: UPDATE"); 
rc = sqfleisig( ftsqlca ); 

(4) 

EXEC SQL CONNECT TO sample IN SHARE MODE; 

(5) 

if ( SQLCODE != 0 ) { 

(6) 

printf{ "\nConnect to error: SQLCODE = 
exit{l); 

*£Ld", SQLCODE ); 

} 


strcpy( STATEMENT, 

(7) 

"UPDATE staff SET job = 'Clerk' WHERE job = 'Mgr'“ ); 

EXEC SQL EXECUTE IMMEDIATE :STATEMENT; 
if ( SQLCODE != 0 ) 

(8) 

printf( "\nUpdate error: SQLCODE = Xld 1 

", SQLCODE ); 

else 


printf( r, \nAH managers demoted to clerk!" ); 

EXEC SQL ROLLBACK; 

(9) 

printf( "\ndn second thought...changes rolled back." }; 

EXEC SQL CONNECT RESET; 
if ( SQLCODE != 0 ) { 

(10) 

printf( "\nDisconnect error: SQLCODE = 
exit(l); 

7ad", SQLCODE ); 

> 

return 0; 


> 



Figure 6,a UPDA TE. SQC sample program (see numbered explanation on page 20) 
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How the Sample Update Program Works 

1. Define Database Manager APIs. Applications written in compiled languages use include files 
to define DB2/2 APIs such as the INSTALL SIGNAL HANDLER API. 

REXX applications do not call DB2/2 APIs directly. Instead, DB2/2 APIs are invoked using an 
intermediate API, SQLDBS. SQL statements are invoked similarly using the SQLEXEC API. The 
SQLDBS and SQLEXEC APIs must be registered using the REXX rxfuncadd function. 

2. Define an SQLCA structure. The INCLUOE SQLCA statement defines and declares an SQLCA 
structure and defines SQLCODE as an element within the structure. The SQLCOOE field of the 
SQLCA structure is updated with error information by DB2/2 after execution of SQL statements 
and DB2/2 API calls. 

REXX applications have one occurrence of an SQLCA structure, named SQLCA, predefined for 
application use. It can be referenced without application definition, 

3. Declare host variables. The BEGIN DECLARE SECTION and END DECLARE SECTION statements 
delimit the host variable declarations. Host variables are used to pass data to and from DB2/2. 
They are prefixed with a colon (:) when referenced in an SQL statement. 

REXX applications do not need to declare host variables. Host variable data types and sizes 
are determined at run time when the variables are referenced. 

4. Install signal handler. Install a signal handler to intercept the Ctrl+Break and the Ctrl+C sig¬ 
nals. Every production application should have a signal handler, 

5. Connect to database. The program connects to the sample database. The program requests 
shared access to the database. Other programs that attempt to connect to the same database in 
share mode are also granted access. 

6. Check completion. The SQLCA structure is checked for successful completion of the CONNECT TO 
statement. An SQLCODE value of 0 indicates that the connection was successful. 

7. Copy SQL statement text to host variable. The statement text is copied into the data area 
specified by the host variable, STATEMENT. Literal values in the statement are delimited with sin¬ 
gle quotes. 

8. Execute the SQL statement. The SQL statement is executed dynamically using the EXECUTE 
IMMEDIATE statement. There are two types of embedded SQL statements: dynamic SQL and stat¬ 
ic SQL. Dynamic SQL allows statement specification at run time, as in the example. Static SQL 
must be specified completely at precompile time. 

9. End the transaction. End the unit of work with a ROLLBACK statement. The result of the SQL 
statement executed previously can be either made permanent using the COMMIT statement or 
undone using the ROLLBACK statement. All SQL statements within the unit of work are affected. 

10. Disconnect from database. The program disconnects from the database by calling the CONNECT 
RESET statement. A pointer to the SQLCA structure is passed on the call. Upon return, the SQLCA 
is checked for successful completion. 


OS/2 DEVELOPER 






This 


Introducing 
Graphics 
I nterface 
Kit/2 


program 


contains 

scenes 


[JlAktirsG Ro 


AHw grtpi Dwanlmn PBwngir 


m zw 101 



LL 


B--v' 



of a 
graphic 

nature. 


But don*t worry. It’s all in good clean fun. Because now there’s 
a fast, cost-effective way to create graphic, easy-to-use inter¬ 
laces for OS/2*2.0 applications and tools. Introducing Graphics 
Interface Kil/2 (GIK/2), an AD/Cycle* product from IBM 
Programming Systems. 

GIK/2 makes it easy to produce and manipulate symbolic 
representations of data without writing a single line of Presentation 
Manager" code. It automatically generates C code, where 
you can link the graphic symbols to the application data 
they represent. This not only speeds up your development 
cycle, it also helps you create applications that are intuitive 
and easy-to-use. Simplify transaction systems. Make databases 
easy to access. Bring organizational charts to life. Track 
inventory with simple icons. Any application can he 
made easier with the right graphic front-end. And GIK/2 
can help you make it happen. 


For orders or additional information, please call 
1 800 IBM-CALL and ask for Department S71. If you 
need graphic proof, ask for our evaluation demo which, 
by the way, is rated G. 



*IBM, OS/2, AD/Cycle and Presentation Manager are registered trademarks of Internationa! Business Machines Corporation, ©1993 IBM Corp, 
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Database Application Programming 
Glossary 

Structured Query Language (SQL). SQL is a standardized, database lan- 

S . DB2/2 orovidesror data definition, retrieval, update, and control opera- 
:hrougb SQL. 

Application Programming Interface (API). An API is a published subroutine or 
function interface. APIs enable user-written programs to control database features 
(especially those not covered by SQL). 

Host Language. A host language is a programming language in which database 
applications are written API calls and SQL statements are placed in a host lan¬ 
guage source program. 

Source File . A source file is a file containing SQL statements embedded within a 
host- language source program. A source file must have one of the following exten¬ 
sions: 

* C source program™. SQC 
* COBOL source program—.SQB 
* FORTRAN source program—SQF 
• REXX source program—CM07 

Embedded SQL Embedded, SQL statements are SQL statements placed in a source 
file along with host-language statements. 

Precompiler. A precompiler is a program that processes source files (for a compiled 
language) containing both host language statements and embedded, SQL statements. 
The precompiler converts the SQL statements to QB2/2 run-time services API calls 
and produces a modified source file with one of the following extensions: 

» C program—.C 
• COBOL program— CBL 
* FORTRAN program—FOR 

The modified source file can be processed by the host language compiler. The pre¬ 
compiler may also produce a bind file, a package, or both. Because REXX is an inter¬ 
preted language, no precompiler or compiler is requried 

Static SQL Static SOL statements are statements that are prepared at pre- 
compile time. 

Dynamic SQL Dynamic SQL statements are statements that are prepared at run time. 

Bind File. A bind file is a file that contains an internal representation of the SQL 
statements in a source file (and its nested EXEC SQL INCLUDE files). Bind files enable 
users to bind an executable program to a database without access to the source 
code 

Package. A package contains the same information as a bind file, but a package 
is stored in the database. Packages can be created at precompile time (by 
default) or explicitly with the binder In OS/2 Database Manager (OS/2 Extended 
Edition and Extended Services), a package was known as a plan file. 

Binder. A binder is a program that reads a bind file and stores the resulting 
package in a database. When an application is run, the package is used to 
access data in a database 


including the SQLENV include file. 

Stack Requirements. Database appli¬ 
cations require that you define stack 
space. In general, stand-alone applica¬ 
tions require more stack space than 
client/server applications. The sample 
database applications provided with 
DB2/2 require a stack size of 32K. 

SAMPLE UPDATE.SQC APPLICA¬ 
TION 

Figure 6 shows the sample program 
UPDATE.SQC and demonstrates some of 
the concepts I've discussed, UPDATE.SQC 
accesses the staff table in the SAMPLE 
database and changes all managers to 
clerks. Then the program cancels the 
changes by performing a rollback. 

APPLICATION ASSEMBLY 

To build database applications, you 
need the following tools. 

Text Editor. Use the OS/2 Enhanced 
Editor provided with OS/2 or any 
other text editor. 

Compiler. Install your host language 
compiler. The supported list of OS/2 
compilers for DB2/2 application devel¬ 
opment are: 

* IBM C Set++ 1.0 (C component only) 

* IBM C Set/2 1.0 

* Micro Focus COBOL 3.0 

* Watcom FORTRAN 

If you are using REXX, be sure that 
it is installed from the OS/2 product 
disks or CD-ROM. 

Database . Be sure that DB2/2 (sin¬ 
gle-user) or DB2/2 (client/server) is 
installed. 

Sample Database. Install the sample 
database provided with DB2/2, if a 
database does not exist. Start DB2/2 
and type SQLSANPL G: at an OS/2 win¬ 
dow. This will install the SQLSAHPL data¬ 
base on G:. If a drive letter is not speci¬ 
fied, the database will be installed 
where DB2/2 is installed. When you 
attempt to connect to the database, you 
will be prompted for a user ID and 
password. The default user ID is USERID. 
The default password is PASSWORD. 

Sample Programs. Install the sample 
programs that DB2/2 provides to 
assist database application develop¬ 
ment. The file SAMPLES. ZIP is stored in 
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The OS/2 software installer 


InstaUSHIELD 


The world’s leading 
applications use it. 

Shouldn’t you? 


First impressions last! 

Use InstaUSHIELD to create a 
bulletproof installation system for 
your application. Easy to use. 
Unconditionally guaranteed. 

ENTIRELY NEW IN VERSION 2.0: 

■ Create Truly Professional Installations in a Matter of Hours 

■ Complete Logic/Flow Control Over Your Installation 

■ Intelligently Create Workplace Shell Objects, Folders, 
Templates and Modify .INI, CONFIG Files 

■ Fully CUA ‘91 Compliant, 32-Bit Multi-Threaded Execution 
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Figure Z Seven basic steps for database application development 


the root directory of Disk 1 of the 
DB2/2 product disks. To install the 
sample programs, insert Disk 1 into 
the I: drive and type the following 
code at an OS/2 Window: 

pkunzip -d s:\samples\sqllib\samples 
For the purposes of this article, the 
UPDATE.SQC application will be precom¬ 
piled using the DB2/2 SQLPREP tool and 
compiled and linked using C Set++ {C 
component) in the WorkFrame/2 2,0 
application-development environ¬ 
ment 

The following compile options 
(flags) are only a small subset of the 
options provided by each compiler. In 
most cases, the default options are suf¬ 
ficient. Check your compiler's docu¬ 
mentation for a complete description 
of available compile options. Suggest¬ 
ed options for C Set++ are: 

* Sm allows migration extensions. This 
may help when migrating applica¬ 
tions, For better portability consider 
S2 or Sa. 

* Gm+ links with the multithreaded 
version of the library. Use this 
option if you want to write multi¬ 
threaded applications, 

* C+ performs compile only. This 
assumes that compiling and linking 
are separate steps. 

* 0- turns optimization off. It is easier 
to use a debugger with optimiza¬ 


tion off, 

• Ti+ generates debugger information. 

The host-language linker creates an 
executable application. The application 
can be an executable load module 
(,EXE file) or a dynamic link library 
(.DLL) module. Required options are: 

• NOI stands for "No Ignore Case" and 
forces case sensitive identifiers. 

• sql_dyn ,lib insures your link with 
the DB2/2 32-bit library. 


* ST: 32000 indicates the stack size may 
have to be increased more than the 
default. 

Other suggested linker options are: 

* DEBUG includes debugging informa¬ 
tion, 

* EXEPACK packs executables, 

■ upm.lib initializes user profile man¬ 
agement (UPM), If using UPM 
APIs, be sure to link to the UPM 
Library. 

Database application development 
can be summarized in seven basic 
steps, as illustrated in Figure 7, 

/. Create The Source Code. Write the 
source code in a standard ASCII file. 
Embed SQL statements and calls to 
APIs in the code. Save the file with the 
correct file extension, such as ,SQC for 
programs written in C. 

2. Precompile the Source File. Only 
precompile source files with embed¬ 
ded, SQL statements. SQLPREP converts 
SQL statements into comments and 
generates language-specific calls for 
the SQL statements. You can specify to 
build the package, bind file, or both. 
This step produces a modified source 
file, an optional bind a file, and an 
optional package. 

3. Compile the Modified Source File. 



Figure 8 , The settings notebook for a QB2/2 action profile 
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The Impact Formatted Entryfields are 

a completely new window class which allows 
the developer to specify a format string 
when the entryfield is created. Formatting 
can be used for fields like Phone Number, 
Dates, Social Security Number, etc. 

The Impact Formatted Entryfield 
dynamically formats itself as the 
user inputs data. 

The Impact Formatted Entryfield 
support assures uniformity in 
data entry. 
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SQL Server Ingres 

Informix DB2/2 
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The Object-Oriented 
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developing database applications. Stop using 
simple generic C APIs. Inherit the power now. 
Access database specific features with powerful 
C++ classes. No more embedded SQL or 
precompilers. Realize more flexibility than ever 
before. 

Multi-Platform Support (1(> 
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Database Class Library is designed to take 
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Figure SL Performing a precompile using PRE-COMPILE 


Compile all the modules, including the 
ones that were precompiled. This step 
produces object modules, 

4. Link the Object Modules. Link the 
object modules with the proper link 
libraries to produce the executable file. 

5 . Bind the Application to a Database r 
Bind application to the databases to 


create a package that contains instruc¬ 
tions for accessing the data requested 
by the application. This step uses the 
bind file that was created in the pre¬ 
compile step. Binding is not necessary 
if it was done with precompilation. 

ft Run the Executable File. Run the 
application and verify the results. 


7. Distribute Executable and Bind Files. 

Distribute the executable and bind files 
for your application, if your applica¬ 
tion is to be used with different data¬ 
bases or on different workstations. You 
will then need to bind the application 
to each database it will access. 

PRODUCTIVITY USING WORK - 
FRAME/2 v. 21 

DB2/2 can be used with the new 
WorkFrame/2 2,1 application develop¬ 
ment environment to gain higher lev¬ 
els of productivity. The first step in 
integrating DB2/2 is to create an action 
profile. An action profile is a set of 
actions associated with one or more 
projects. Figure 8 shows the settings 
notebook for a DB2/2 action profile. 
The PRE-COHPILE action, which identifies 
the SQLPREP tool, has been created. 

The PRE-CDMPILE action performs a 
precompile of the application using 
SQLPREP and automatically binds the 
application to the sample database. 
PRE-COMPILE will also appear in the 
icon's pop-up menu. When you want 
to perform a precompiie in the Work¬ 
place Shell, just point to the 
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Figure 10 . Displaying the output from the precompile 
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The complete 

Now available on OS/2 - The ASK INGRES Intelligent Database. The 
very same database that has proved so popular with hlue chip 
organizations and high-end professional users in commerce, industry 
and Government. 

Fully featured, fully portable, fully scalable* 

The ASK INGRES Intelligent Database is a leading edge, intelligent, 
relational database, ideally suited to client/server applications. ASK 
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as well as IBM SNA, enabling communication with DB2 and IMS. 
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OS/2 solution* 
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performance into character-based application development and 
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UPDATE.SQC icon and select PRE-COH- 
PHE from its menu, as shown in Fig¬ 
ure 9. 

You can choose to display the out¬ 
put from the precompile in a text win¬ 
dow, a full-screen window, or a Work- 
Frame/2 monitor window, as shown 
in Figure 10. 

The output from the PRE-COMPILE 
action is the file UPDATE.C. 
UPDATE.C can now be compiled 
using C Set++ or C Set/2 and linked to 


create UPDATE.EXE. 

For additional information about 
WorkFrame/2, consult the Work- 
Frame/2 2.1 Introduction manual. 

CONCLUSION 

DB2/2 provides a third-generation 
language application development 
solution that allows programmers to 
develop database applications. The 
WorkFrame/2 2.0 provides an applica¬ 
tion- development environment 
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designed for increased programmer 
productivity. 
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■ Database 


This article provides insight into how a visual REXX tool can be used with OS/2 and DB2/2 to create database 
applications quickly. Journey through the creation of the Games Museum database prototype, from database 
structure, to using SQL from VX-REXX, to storing images in an application. BY 6ft ACE welch 



Prototyping Database 
Applications with VX-REXX 



Grace Welch 


I Jl m hen the Museum and Archive of Games 
mm mm at the University of Waterloo, Canada 
» » considered downsizing its inventory 
database from the mainframe to a PC, it looked to 
two neighbors: IBM with its DB2/2 relational data¬ 
base system that was developed in nearby Toronto; 
and WATCOM, with its new VX-REXX visual 
development environment for OS/2 2.x that was 
created right in Waterloo. The two were good can¬ 
didates for providing the solid, visual-development 
environment and powerful database platform the 
Museum needed. But rather than jumping into the 
development, the University decided to prototype 
the application with VX-REXX. 


SYSTEM HISTORY OF THE MUSEUM OF GAMES 

The Museum and Archive of Games manages the 
world's largest collection of games. The collection 
houses 5000 pieces, ranging from ancient card 
games to modem pinball. Twenty years ago, the 
museum boasted one of the most technologically 
advanced, col lection-management systems in the 
industry . Each item in the museum was described 
in detail and recorded in a then-state-of-the-art 
VM/CMS-based hierarchical database called 
SPIRES, The conversion of the old, paper-bound 
ledger management system to an on-line, main¬ 
frame database greatly benefited the museum's 
curators. For a long time, the museum had wres¬ 
tled with the problem of keeping information on 
each collection piece up-to-date. The museum 
operators needed to describe each piece as it was 
received, periodically adding information, such as 
a fading color problem and the resulting treat¬ 


ment, to the description. The on-line database han¬ 
dled the accumulation of such information more 
conveniently than the paper system. 

IMPROVING ON THE MAINFRAME SYSTEM 

Two major factors caused the museum to seek a 
new, database solution. First, the nature of the muse¬ 
um's business changed. The museum shifted its 
focus from administration (or recording) to commu¬ 
nity and industry sendee. As a result, the database 
needed to change from an internal, administrative 
tool to a publicly available system. In particular, the 
museum wanted the database to provide easy-to- 
use, on-line information that included pictures of 
the exhibits. This way, customers could Find infor¬ 
mation about games and their trends and history in 
a visual and interactive manner. It was not possible 
to achieve this ease of use within the bounds of the 
existing mainframe system. 

Second, many university departments were 
downsizing their systems from the mainframe. 
During his search for an alternative platform, 
Elliott Avedon, a conservator of the museum, 
found a PC technology capable of meeting the 
museum's new requirements. Avedon viewed 
OS/2 and DB2/2 as powerful, user-friendly, and 
flexible building blocks for the Museum's database 
improvement. He started a project that examined 
the feasibility of moving the SPIRES database sys¬ 
tem to OS/2 and DB2/2. 

MEETING THE CHALLENGE 

Jennifer Uttley, senior researcher and developer of 
the University of Waterloo's Computer Systems 
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Group, took an interest in the museum database 
project The project dealt with a problem in the 
area of her research: how to handle information 
about things, people, and events in a highly 
descriptive and usable manner. Within a couple of 
weeks, Uttley had created a working database pro¬ 
totype for the museum. 

THE NEW LOOK OF THE 
GAMES MUSEUM DATABASE 

The prototype database looked nothing like the 
SPIRES original. Instead of a text-based interface, 
the new database had a graphical user interface 
that included easily manipulated menus, drop¬ 
down list boxes, radio buttons, and push buttons. 
Figure 1 depicts the graphical user interface of the 
database prototype. The old, data-retrieval method 
of entering arcane SPIRES commands disap¬ 
peared. Now, Museum customers could retrieve 
data by simply pointing and clicking on the new 
OS/2 interface, in addition, the database prototype 
offered new features, including picture storage, 
query by example, and ranked text searches. 


Museum Database 


File Search SlideShow Image 


Mein Name; 


SENET 


Image: 



Accession Number: 


978.007.01.24 


Date Acquired: 


OBJECT 


UNKNOWN SOURCE 


Description: 


Classification: 

Location: CABINET 6 ~SHELF 
Source: 


Afternative name for Passing Through the 
Game of 30 Squares. CONTAINER: Lid shows Egyptian tomb 
painting of 2 people playing the game. Yellow background with 
blue - green - white - orange borders of Egyptian design. Plain 
white inside. White bottom. BOARD: divided into 30 squares each 

mtmhorofl chmuc Hifortlnn nf nlaij I afnn Fmin-tfo 


1978 


I 


Search 




keyword Search 


Add to SlideShow 


Clear 


Exit 


THE GAMES MUSEUM 
DATABASE STRUCTURE 

The Games Museum Database prototype is based 
on IBM DB2/2, a relational database that groups 
information into tables. These tables are related to 
each other through primary keys. The main table 
of the prototype consists of three types of fields. The 
fixed information fields include fields for the acces¬ 
sion number (a unique identification number for 
each piece in the collection), the title of the item, the 
date that the item was acquired, and the market 
value of the item. The main table also includes a 
description field large enough to hold several para¬ 
graphs of information. Many smaller fields in the 
SPIRES database were collapsed to form this field. 
The new, all-inclusive description field offers an 
easier way to enter information that is not easily 
categorized. To ensure that the specific information 
can be easily found within the field, the prototype 
application includes the ability to retrieve records 
using a text search on the field. The main table also 
includes fields that contain the names of the images 
associated with each museum piece. 

Other tables connect directly or indirectly with 
the main table of information. One of these tables 
includes categories (that is, object, photograph, or 


Figure h A view of the new Games Museum database application 
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Figure 2. The database structure displayed in an entity-relationship diagram 
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Figure 3. The main screen of the Games Museum database 


book), and another includes donors. 
Figure 2 describes the Games Museum 
database structure in an entity-relation- 
ship diagram. 

QUICK USER INTERFACE 
DEVELOPMENT 

Developing a graphical user interface 
with a language such as C or C++ is 
complex. Using a visual tool, Uttley 
was able to create the graphical user 
interface for the Games Museum appli¬ 
cation quickly and easily. The VX- 
REXX development environment 
makes controls available in a toolbar. 
These controls were added to the 


Games Museum database application 
by selecting them from the toolbar and 
dropping them onto application win¬ 
dows. Once placed on a window, each 
control's position, color, text, and other 
attributes were easily customized. Fig¬ 
ure 3 shows the main window of the 
Games Museum database as it appears 
in the WATCOM VX-REXX visual 
development environment. 

EVENT-DRIVEN PROGRAMMING 

The user interface is connected to the 
application code by events. When a 
developer clicks on a button, for exam¬ 
ple, the button generates a click event. 


Event code is written in standard OS/2 
REXX. VX-REXX's drag-and-drop pro¬ 
gramming allows the developer to 
write the event routines without typing 
code. The developer simply drags and 
drops controls from the application 
window into the event routine, then 
selects the desired action from a list. 
Figure 4 illustrates this drag-and-drop 
programming feature. The code for 
each event can be edited separately, or 
all the code can be edited at once. Edit¬ 
ing all of the code at once is useful for 
making global changes or for getting 
the big picture of an application. Devel¬ 
opers also have the choice of using the 
built-in, VX-REXX editor or configur¬ 
ing the system to use an external editor. 

CALLING DB2/2 

DB2/2 includes an application pro¬ 
gramming interface (API) for REXX. 
An application, such as DB2/2, that has 
a REXX API provides routines a REXX 
program can call to interact with that 
application. Because VX-REXX is inte¬ 
grated with OS/2 REXX, it can be used 
with any REXX API. In addition, some 
applications are REXX-aware. Users 
can call macros written in REXX from 
within the application. The OS/2 
Enhanced Editor and Lotus's AmiPro 
are two examples. VX-REXX can be 
used with this type of application to 
create visual macros. 

Using DB2/2 involves: 

1. Registering the DB2/2 routines 

2. Starting DB2/2 



Figure 4. Drag-and-drop programming can eliminate the need to write code 
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Figure 5. Code sample from the click event 


3. Declaring a cursor 

4. Issuing a SQL statement 

5. Displaying the data 

6. Closing the cursor 

7. Stopping DB2/2. 

Many of these actions involve using 
two DB2/2 routines. SCJLEXEC is used to 
process all SQL requests. SQLDBS is used 
to call DB2/2 environment and utility 
routines. 

Issuing an SQL statement and dis¬ 
playing the data are described in the 
following section; more information 
about using DB2/2 with REXX is 
described in the WATCOM VX-REXX 
for OS/2 Programmer's Guide and Refer¬ 
ence and in the Database 2 OS/2 Pro¬ 
gramming Reference. 

USING SQL 

The Games Museum database applica¬ 
tion communicates with the DB2/2 data¬ 
base through SQL statements embedded 
in REXX functions. For example, when 
the right arrow button is pushed on the 
application's main window, the embed¬ 
ded SQL statement, FETCH, is issued to 
retrieve and display the fields of the next 
record in the database. In Figure 5, a 
code sample from the click event routine 
of the Next button provides a behind-the- 
scenes look at how SQL is used. In the 
sample, the call to the SQLExec routine 
finds the next record. The following 
three calls to VRSet display the values of 
the three variables that were found. 

CREATING A RANKED 
TEXT SEARCH 

The Games Museum database applica¬ 
tion features a ranked text search on 
the description fields of each record. 
The ranked text search, called a "key¬ 
word search" in the application, 
requests a word or series of words from 


the user to form a search pattern. The 
resulting matches are ranked by how 
well they match the original search 
words. The order of the search results 
does not reflect the order in which the 
words appear in the description; the 
results are arranged in descending 
order by the number of words in the 
text string that satisfy the search query. 

Before the search, certain words that 
have no important meaning of their own 
are eliminated, such as it, or, and, the, and 
that. Characters such as brackets and 
punctuation marks are also removed. 

The search runs very quickly, because 
the database includes a search word 
index table called "Words," as shown in 
Figure 6, This index contains the descrip¬ 
tion text broken into individual words. 
Stop words and unnecessary characters 
are not included, A separate, VX-REXX 
program compiles the word index as 
part of the update procedure. 

Suppose you want to search the 
Games Museum database for the string 
"An early American game board." The 
search procedure would issue the SQL 
statement in Figure 6. The SELECT state¬ 


ment causes the database to return 
three fields: the accession number, item 
name, and number of words matched. 
Only descriptions containing at least 
one word from the search list will be 
selected. The ORDER BY clause causes the 
rows to be returned from the database 
in decreasing order of number of 
matches, thus ranking the matches. 

TAPPING INTO OS/2 
MULTIMEDIA CAPABILITIES 

The Games Museum database applica¬ 
tion stores full-color images of muse¬ 
um pieces for many of the museum 
records. Like the Games Museum data¬ 
base application, other applications can 
benefit from this capability. Since a pic* 
ture is worth a thousand words, pic¬ 
tures can replace descriptive text using 
only one field. They also accurately 
reflect the attributes of items and aid 
the usability of a database. Finally, 
users can use pictures for presentations 
and other external uses. For example, 
the Games Museum database applica¬ 
tion provides a slide show feature. The 
slide show consists of one or more item 
pictures and their attached descrip¬ 
tions, The slide show can be loaded on 
a disk and sent to customer sites to pro¬ 
vide education and information. The 
slide show presentation is quick to 
develop, paperless, easy-to-use, and 
inexpensive. It can reduce the need for 
personal, on-site visits. 

The museum pictures are stored in the 
database as digitized images. To create 



Figure 6. SQL statement issued by search procedure 
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them, 35mm slides were scanned by a 
Nikon LS3510/ AF. The resulting high-res¬ 
olution files were converted to 256-color 
bitmap files using Image Alchemy, a con¬ 
version program. The program Wingif 
was then used to dither the files into a 16- 
color format that would allow low-reso¬ 
lution monitors to display the images. 

The VX-REXX picture-box control 
was used to draw a box that would 
contain the images. At run time, assign¬ 
ing the path of the bitmap file to the 
picture box's PicturePath property caus¬ 
es the picture to be displayed. 

Avedon also sees the potential of tap¬ 
ping into further multimedia capabilities 


available from WATCOM VX-REXX. The 
Museum carries many games that involve 
sound and motion. To accurately depict 
these games and how they are played, the 
database could be modified to support 
audio and motion picture fields. In fact, 
these multimedia records could play on 
separate, simultaneous threads for added 
convenience and interaction. 

THE FUTURE OF THE GAMES MUSEUM 
DATABASE PROTOTYPE 

Avedon expressed enthusiasm for the 
future of the Games Museum database 
after reviewing Jennifer Uttley's Games 
Museum database prototype. The proto¬ 


REFERENCES 


type allows him to present the proposed, 
database alternative to colleagues in a 
visual and realistic manner. 

As for the final production version, 
issues regarding the transition of a hier¬ 
archical database to a relational database 
remain in debate. However, the ability 
to store images, a GUI front end, easy 
maintenance of the information, sophis¬ 
ticated, word search features, and usabil¬ 
ity of the database were all major 
improvements over the mainframe ver¬ 
sion of the database. 
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BY LEON KATSNELSON 


Whatever Happened to 
OS/2's Database Manager? 



Leon Katsnebon 


f ver since PCs moved from tape cassettes 
and floppies to hard disks for storage, pro¬ 
grammers have been seeking better ways 
to store and access data. Their quest for fast and 
efficient, data-access methods led to the introduc¬ 
tion of such popular PC database systems as Bor¬ 
land's dBASE and later, Paradox. These products 
offered not only data access but also tailored pro¬ 
gramming languages {such as xBASE and PAL) and 
development environments for both novice and 
experienced, application developers. Over the 
years, dBASE and Paradox have become de facto 
database formats for standalone, PC applications. 

The introduction of record locking and file 
sharing in DOS and the growing popularity of 
local area networks (LANs) caused many pro¬ 
grammers to use LAN file servers for data shared 
by several users. While these innovations provid¬ 
ed many benefits, they also had their shortcom¬ 
ings. File-server database management systems, 
such as dBASE and Paradox and Microsoft's Fox¬ 
Pro and Access, which send data from the server 
to a client PC for processing, were simply not effi¬ 
cient enough to handle the demands of mission- 
critical applications. Worse, they lacked guaran¬ 
teed, referential integrity and transaction-process¬ 
ing capabilities. Nevertheless, these PC databases 
became a popular way to share application-specif¬ 
ic data among a small number of LAN users. 


THE MAINFRAME DATABASE 

While PC programmers busily dealt with the com¬ 
plexities of robust, data-access mechanisms, main¬ 
frame programmers at IBM's Santa Teresa Labora¬ 


tory implemented a new model for data organiza¬ 
tion and access known as a relational database. 
The result of this effort was a relational database 
management system (RDBMS); IBM Database 2 
(DB2) was born. Later, IBM delivered an RDBMS 
for the VM and DOS/VSE operating systems 
(SQL/DS) and included RDBMS function in the 
GS/40Q operating system for the AS/400 family 
of minicomputers. 

In 1987, IBM and Microsoft jointly announced 
the arrival of a new generation of operating sys¬ 
tem, OS/2. Availability of a relational database 
was vital for OS/2 acceptance within the business 
community; the multitasking and multithreading 
capabilities of OS/2 made building a RDBMS easi¬ 
er. As a result, FBM announced a special version of 
OS/2, OS/2 Extended Edition, which included a 
communication subsystem and an RDBMS built 
using DB2 technology. The RDBMS component 
was called Database Manager. Applications run¬ 
ning on a variety of IBM systems from inexpen¬ 
sive Intel-based PCs to minicomputers and large 
mainframes were now able to use the power of 
relational databases. 

CLIENT/SERVER—THE BEST 
OF BOTH WORLDS 

While IBM's RDBMS design provided the 
advanced facilities of relational database systems, 
such as structured query language (SQL), data 
integrity, data security, and transaction process¬ 
ing, these benefits were only available to the appli¬ 
cations running on the same CPU as the RDBMS 
itself. With the growth of LANs and an increase 
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in popularity of graphical user interfaces fueled by 
inexpensive PCs, a new model for data access— 
client/server RDBMS—came into being. Under the 
client/server mode of operation, the relational 
database manager (database server) and the appli¬ 
cation that accesses data (database client) can 
reside on different machines connected via a 
telecommunication network* 

In the client/server paradigm, client machines 
typically handle application-specific tasks and 
request data from database servers by passing an 
SQL request as a message to the database server. 
The results of each SQL command are returned 
over the network. The server processes the SQL 
request and returns only the requested data, rather 
than passing all the data back to the client to let it 
find what it needs, as is the case with file-based 
databases. The result is a more efficient utilization 
of distributed, processing power. 

In 1990, OS/2 Extended Edition embraced the 
client/server paradigm by providing support for 
remote DOS and OS/2 clients. In 1992, the Data¬ 
base Manager component of Extended Sendees for 
OS/2 (successor to OS/2 EE) extended this sup¬ 
port to applications written for Microsoft Win¬ 
dows 3.0. Also in 1992, IBM delivered Distributed 
Database Connection Services/2 (DDCS/2). 
DDCS/2 is an implementation of distributed rela¬ 
tional database architecture (DRDA) that allows 
DOS, Windows, and OS/2 applications written for 
the Database Manager to access DB2, SQL/DS, 
and QS/40G data transparently. In effect, DDCS/2 
brought the rest of the DB2 family into the 
client/server world. 






DDCS/2 


DDCS/6000 







Servers 





f 

Clients 


1 1 1 


□ 




C2_1 



DOS Windows OS/2 AIX 


Figure 1. IBM DB2 family of client/server RDBMS 


• DB2/2 Single User. Provides an RDBMS func¬ 
tion for multiple, OS/2 applications sharing the 
PC with DB2/2* 

* DB2/2 Client/Server, Provides a server-based 
RDBMS for multiple, DOS, Windows, and OS/2 
applications running on remote, client PCs* 

In July 1993, IBM extended its DB2 line of 
RDBMSs by introducing a UNIX-based database 
server, DB2/6O0G, for the IBM's RISC System/6000 
family of processors running the AIX operating 
system. IBM's DB2 family is shown in Figure 1. 


WHAT S IN THE NAME? 

Because Database Manager for OS/2 had become 
a client/server RDBMS and is no longer a compo¬ 
nent of OS/2, it was transferred to IBM's Software 
Solutions Division, which is responsible for 
RDBMS direction* The IBM's Toronto Laboratory, 
responsible for SQL/DS, became the new home 
for Database Manager. In May 1993, a full 32-bit 
implementation of Database Manager with many 
of DB2's compatibility, performance, and quality 
enhancements was released. This new product is 
called IBM DB2 OS/2 (DB2/2), sold separately 
from the old Communication Manager compo¬ 
nent. As with OS/2 ES 1.0, DB2/2 is offered in a 
choice of two packages: 


ACCESSING DB2 FAMILY DATA FROM OS/2 

As a developer, you are interested in accessing the 
data stored in an IBM RDBMS from your OS/2 
applications. IBM, together with a large number 
of third-party suppliers, offers tools that help you 
develop OS/2 applications that work with data 
stored in DB2 databases. IBM DB2 products pro¬ 
vide two types of tools: 

* DB2 Family Development Tools And Utilities. Tools 
and utilities for building applications that access 
DB2 data. 

* DB2 Family Application Enablers. Run-time sup¬ 
port for applications that are built using these 
tools. 
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DEVELOPMENT TOOLS 

OS/2 applications that access DB2 data 
can be developed using one of two 
methods: embedded SQL or call-level 
interface (CLI) commands. 

Embedded SQL will be familiar to 
programmers experienced with host 
database systems such as DB2 for MVS, 
DB2/VM, or VSE (formerly SQL/DS), 
SQL commands are entered as source- 
code statements. Because most compil¬ 
ers cannot process SQL statements 
directly, a precompiler converts source 
code into a form that can be processed 
by ccahveritional compilers. While an 
e*tra precompilation step can be 
viewed as m inconvenience, embedded 
SQL is ai preferred approach for many 
application developers because of its 
familiar, SQL interface. Embedded SQL 
can also generate static SQL for better 
performing applications. 

CLI is based on the traditional, func¬ 
tion-call method of invoking a function 
or a procedure to accomplish a task, in 
this case data access. Unlike embedded 
SQL, no preprocessing is required since 
compilers already support function 
calls. 

IBM's implementation of CLI is 
based on an X/Open preliminary-draft 
specification. This allows users to 
migrate applications to other RDBMSs 
that support the same level of CLI. 
IBM's CLI is also compatible with the 
Open Database Connectivity (ODBC) 
specification for Microsoft Windows 
and allows the user to port Windows 
ODBC applications easily to OS/2 or 
other DB2 client platforms such as DOS 
and AIX. 

IBM offers two products that pro¬ 
vide tools and utilities for OS/2 appli¬ 
cation developers: 

* DB2/2 (either single-user or 

client/server versions) 

* DB2 Software Developer's Kit/2. 

DB2/2 , Both single-user and 

client/server versions of DB2/2 
include an application-development 
environment for building 16- and 32-bit 
OS/2 database applications using FOR¬ 
TRAN and COBOL. DB2/2 provides 
three components that are of interest to 
application programmers: 



Figure 2. DB2/2 Client Application Enabler Distributed Feature environment 


1. A relational database that can be 
used for testing applications without 
disrupting operations of a produc¬ 
tion server or changing operational 
data. 

2. C, FORTRAN, and COBOL precom¬ 
pilers; code samples; and documen¬ 
tation for developing embedded SQL 
applications in those languages. 


3. A command-line processor provid¬ 
ing interactive, SQL capabilities that 
allows programmers to prototype 
SQL statements. 

Applications developed using 
DB2/2 require that either DB2/2 itself 
or the DB2/2 Client Application 
Enabler Distributed feature be available 
in run-time environments. 


DBZ/2 


DB 2/6000 


AS/400 
I_ 


SQL/DS 


DB2 



Figure 3 . DB2 Client Application Enabler/2 environment 
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Whether you’re 

in a Dos, Win-OS2 or OS/2 session 
running under OS/2 2.1, now you have the 
ability to send and receive faxes - without 
leaving the application. Just select the Fax/PM driver 
as your printer. To fax...just print! 

Fax/PM 32-bit also really capitalizes on the 
advanced features of the Workplace Shell 
object-oriented interface. You can send 
faxes right from the Workplace Shell by 
simply dragging and dropping a data 
object to the fax object. 

Features like these are too good to keep 
to yourself, so there are also Fax/PM versions 
available for LAN and Client-Server 
environments, all CID enabled. 

And applications developers will 
appreciate SOM APIs that allow for integration of the 
Fax/PM engine into custom applications. We could 
go on about how Fax/PM can make your PC an even 

more productive place. 
But we’d rather let the fax 
speak for themselves. 
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DB2 Software Developer's Kit/2. 
DB2 Software Developer's Kit/2 pro¬ 
vides an environment for building 32- 
bit OS/2 database applications using C 
and FORTRAN. This product provides: 

1. C and FORTRAN precompilers, 
code samples, and documenta¬ 
tion for developing embedded 
SQL applications in those lan¬ 
guages. 

2. Programming libraries, code 
samples, and documentation for 
developing applications in C 
using the CLI API. 

3. A command-line processor pro¬ 
viding interactive, SQL capabili¬ 
ties so programmers can proto¬ 
type SQL statements. 
Applications developed with this 

product require that the DB2 Client 
Application Enabler/2 be present in 
run-time environments. 

While the DB2 Software Developer's 


Kit/2 does not provide tools and utili¬ 
ties for COBOL programmers, a com¬ 
prehensive, COBOL development envi¬ 
ronment is available from third party 
suppliers such as Micro Focus Inc. 

DB2 APPLICATION ENABLERS 

The choice of DB2/2 or DB2 Software 
Developer's Kit/2 as a development 
environment is based on the applica¬ 
tion's run-time environment. Applica¬ 
tions developed with DB2/2 require 
either DB2/2 or the DB2/2 Client 
Application Enabler Distributed Fea¬ 
ture. Applications developed using the 
DB2 Software Developer's Kit/2 
require DB2 Client Application 
Enabler/2 for run-time support. 

The DB2/2 Client Application 
Enabler Distributed Feature provides 
users with run-time support for OS/2 
applications developed using the tools 
and facilities of either DB2/2 or OS/2 


Extended Services 1.0. It allows appli¬ 
cations to access DB2/2 and, via 
DDCS/2, DB2 for MVS, DB2/VSE and 
VM, and GS/4G0. Both NetBIOS and 
APPC protocols are supported. Figure 
2 shows a typical DB2/2 Client Appli¬ 
cation Enabler Distributed Feature 
environment, 

DB2 Client Application Enabler/2 
provides OS/2 users with run-time 
support for accessing the IBM RDBMS 
via TCP/IP and APPC protocols. To 
improve programmers' ability to 
deploy applications, DB2 Client Appli¬ 
cation Enabler/2 is offered under a 
"location license/' This flexible, licens¬ 
ing scheme allows unlimited use on 
any number of OS/2 workstations of 
the DB2 Client Application Enabler/2 
within a licensed customer location (a 
building identified by a unique street 
address). Figure 3 shows a typical 
DB2/2 Client Application Enabler/2 
environment. 

WHAT ABOUT REXX? 

REXX has become a popular tool for 
many OS/2 developers, offering the 
simplicity of an interpreted batch lan¬ 
guage and the power of a serious pro¬ 
gramming language. DB2's family of 
products provides support for applica¬ 
tions developed using REXX. Using 
new, visuaTREXX development tools 
from WATCOM (VX-REXX) or Hock- 
Ware (VisPro/REXX), REXX program¬ 
mers can create sophisticated, graphi¬ 
cal applications in a matter of days. 
Both visual-REXX products provide 
support for DB2. 

PROGRAMMING AT 
A HIGHER LEVEL 

In the past few years, we've seen 
growth of sophisticated, development 
environments, such as CASE and 
object-oriented tools. These promised 
reduced, application-development 
cycles and better, software quality. 
Many tools first appeared on OS/2 and 
included support for OS/2 Database 
Manager and now DB2/2, These 
included products like Easel, Enfin/3, 



Circle Reader Service Number 21 


OS/2 DEVELOPER 




Application Manager, and Choreogra¬ 
pher. Many of them have been used 
with DB2/2 to build mission-critical 
applications for large corporations* IBM 
entered this market with products such 
as Personal Application System/2 and 
VisualAge/2. VisualAge/2 allows 
application programmers to build com¬ 
plex applications from a library of 
reusable parts. New programming 
tools are being developed or ported to 
OS/2 and enabled for DB2 access* 

IN SUMMARY 

The introduction of DB2/2 and 
DB2/600Q Client/Server RDBMS 
extended the IBM DB2 family to Intel 
and UNIX platforms, IBM and its busi¬ 
ness partners provide OS/2 program¬ 
mers with a variety of tools for creat¬ 
ing mission-critical applications that 


non miss out 

on a single issue of OS/2 

OS/2 Developer offers tips and techniques 
for more efficient computing for the 
advanced software developers who have 
recognized the need for 32-bit power. 



For new orders 8 customer service: 


1-800 WAHT-0S2 

(1-800-926-8872) Or 

708-647-5960 
FAX 708-647-0537 


work with this data. These tools cover a 
range of development environments 
from third-generation languages such 
as C, COBOL, FORTRAN, and REXX to 
object-oriented languages, such as 
SmallTalk, and visual-programming 
tools* DB2 technology is also available 
for applications that used PC databas¬ 
es In the past. For these applications, 
DB2/2 single-user offers the function 
and the same-strength database engine 
as the client/server version. 

To help commercial-applications 
developers take advantage of DB2 
RDBMS, IBM created the DB2 Develop 
er's Assistance Program. Developers of 
commercial applications should call 1- 
800-627-8363 for more information. 

Other articles in this DB2/2 series 
provide an introduction to developing 
OS/2 applications for DB2 RDBMS 


using embedded SQL and an introduc¬ 
tion to the EXPLAIN utility, which 
gives programmers and database 
administrators a better understanding 
of how DB2/2 processes queries and 
how to use this knowledge to improve 
performance of an application* 

Leon Katsnelson, IBM Software Solutions 
Toronto Laboratory, Ont f Canada t is a 
product planner with DB2/2 and DB2/6000 . 
He joined IBM Toronto Laboratory in 1985 
as a software developer. Since then i, he has 
held a number of positions in software 
development testing, and product plan¬ 
ning. He has been working in Database 
Technology Planning since March 1992, 
where he is responsible for client/server 
and DDCS strategy. He received a B.S , in 
computer science from York University, 
Toronto, Ont f Canada . 
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CompuServe hosts OS/2 
developer and user forums, 
monitored by technical 
personnel. IBM developers 
are there with responses to 
anything that's got you stuck. 
Other OS/2 programmers and 
enthusiasts are there, too, 
comparing notes and giving 
feedback. It’s definitely the 
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r Golden 
CommPass 


06/2 Navigation Software 


Time is money when you 
connect to CompuServe, and 
Golden CommPass saves 
you both. It lets you compose 
your questions off-line, send 
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It gets your replies while you’re 
busy programming. 

Golden CommPass keeps 
your development schedule 
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Object-Oriented Programming 


The SOMobjects Toolkit and DSOM offer opportunities to build new and powerful object-oriented applications. 
This article provides an introduction to DSOM programming. BY CHARLES ERICKSON, NURCAN COSKUN, AND 
ROGER SESSIONS 



SOMobjects Developer Toolkit 
Sharing SOM Objects with DSOM 



Charles Erickson 



Nurcan Coskun 



Roger Sessions 


O ne of the most powerful features of the 
second release of the SOMobjects Toolk¬ 
it is the ability to allow access to SOM 
objects from multiple processes. The processes 
may be running within the same machine or on 
different machines connected together on a local, 
area network. 

The extension to SOM that allows objects to 
be distributed among different processes is 
called Distributed SOM (DSOM). While DSOM 
may be considered an extension to the capabili¬ 
ties of SOM, it can also be called an Object 
Request Broker (ORB). DSOM fully complies 
with the Common Object Request Broker: Archi¬ 
tecture and Specification 1.1 published by the 
Object Management Group (OMG) and x/Open. 
This specification is also known as the CORBA 
specification. 

This article provides an introduction to DSOM 
programming by extending the appointment book 
example built in "SOMobjects Developer Toolkit: 
An Overview/" (Nov./Dec. 1993). In that example, 
we implemented a client program that allowed us 
to add appointments to an appointment book. The 
appointment book and the appointments con¬ 
tained within it existed within one process. If we 
were to start a second client program, it would cre¬ 
ate its own, completely separate appointment 
book and appointments. 

Suppose, however, that we want to share a sin¬ 
gle appointment book and its appointments 
among several, different client programs or among 
several instances of the same client program. Also, 
suppose we want the appointment book to be cre¬ 


ated when the first client begins to use it When 
other clients simultaneously use the appointment 
book, they should all use the one created by the 
first client. And finally, we'd like the shared 
appointment book to be destroyed only after the 
last, client program no longer requires access to 
the book. We envision some interprocess commu¬ 
nications scheme, like shared memory, to solve 
this problem. However, we also want to allow 
client programs running on other machines access 
to the appointment book. We factor intermachine 
communications into the scheme. The whole idea 
sounds like a daunting project. 

Instead of handling the interprocess communic- 
hons ourselves, we use DSOM to share the appoint¬ 
ment book. DSOM was created to solve many of 
these difficult problems, so that sharing objects 
between processes is not so difficult. 

To share an appointment book using DSOM, we 
implement it using a DSOM server. A DSOM server 
is a program that, when running, houses the object 
that we want to share. A DSOM server is also a pro¬ 
gram that services requests by other processes to 
access the shared object, 

DSOM provides a client/server model for pro¬ 
gramming applications. An object that is to be 
shared among processes is implemented by a server 
process. Client processes may make use of objects 
implemented at a server via remote method invoca¬ 
tions. With DSOM, remote method invocations are 
made the same way as local method invocations. In 
many cases the only difference between using a 
local-object vs. a remote object is how the object is 
created and destroyed. 
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Before making the appointment book a shared 
object, we must first review what is involved in the 
implementation of a DSOM server- A DSOM server, 
in addition to being the process where the shared 
objects exist, is responsible for accepting client 
requests and converting them into method requests 
on objects within the server process. The server must 
return the output of method invocations to the 
processes that initiated them. A DSOM server also 
accepts requests to create and destroy objects at the 
server. These difficult jobs are taken care of by a few 
key objects provided in the DSOM framework. In 
the server process, these key objects are the SOMob- 
ject Adapter object (an instance of class SOMOA) and 
the Server object (an instance of class SOHDServer or a 
derivation of SQMDServer). 

The SOMobject Adapter, better known as the 
SOMOA object, is created during the initialization of a 
server program. The SOMOA object handles com¬ 
munications with other processes. It accepts requests 
from client programs and converts them into 
method requests on objects in the server process. It 
also converts the output of method requests into a 
message that can be sent back to client programs. 
Only one instance of the SOMOA object exists in the 
server process* 

Client programs use the Server object, among 
other things, to create and destroy objects in a server 
process. The Server object is an instance of the SQL¬ 
Server class or a class derived from SQMDServer To cre¬ 
ate objects, such as the appointment-book object 
within a server, a client program invokes the sond- 
CreateObj method on the Server object. To destroy an 
object, a client invokes the somdDeleteObj method on 
the Server object. Like the SOMOA object, the Server 
object is created during initialization of the server 
process, and only one instance of it exists. 

These two objects do most of the dirty work in a 
DSOM server. To complete the implementation of a 
DSOM server, there are two final pieces to consider: 
a main program for initializing the server and pro¬ 
cessing incoming method requests and the imple¬ 
mentation of a class library. The class library con¬ 
tains the implementation of the objects that will exist 
in the server process and will be shared among the 
clients of the server. 

The DSOM server initialization and request pro¬ 
cessing that is done by the main program of a 
DSOM server can be handled the same way for 
many sewer implementations. To avoid the tedium 


01 tindude Csomdserv *idl> 

02 

03 #include <apptbook*idl> 

04 

05 interface AppointmentBookServer : SQMDServer 
06 { 

07 

08 #ifdef _SQHIDL_ 

09 implementation 

10 { 

11 // Class Modifiers 

12 dTLnaine = "apptbk.drr; 

13 

14 // Instance data 

15 unsigned long numberOfUsers; 

16 AppointmentBook apptBook; 

17 // This is the one an only appointment book which can be used by 

18 // clients of this AppointfflentBookServer. 

19 

20 // Method Modifiers 

21 somlnit: override; 

22 

23 somdCreateObj : override; 

24 // Creates an object of the specified class. 

25 // If the object is of class "AppointmentBook"* return the one 

26 // and only AppointmentBook object. 

27 

28 somdDeleteQbj : override; 

29 // Dispose of the given object and any references to it* 

30 // If the object is the one and only AppointentBook managed by 

21 U this server, free the object and set the apptbook attribute to 

22 // NULL* 

23 >; 

24 flendif /* __30M3DL_ */ 

25 }; 

Figure f. The IDL for the new Server object 

of writing the same, main program time and time 
again, DSOM supplies a precompiled and linked 
server program named somdsvr.exe. 

This server program sets up the DSOM run time, 
including the S0MQA object, and goes into a request 
loop. In the request loop, DSOM waits for a method 
request to arrive. When a request arrives, it is 
processed by the SOMOA object and dispatched by the 
Server object. If necessary, DSOM will dynamically 
load a dynamic link library (DLL) containing the 
implementation of an object. After the method 
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request is processed, DSOM returns to 
the top of the loop and waits for the next 
method request. The somdsvr.exe pro¬ 
gram satisfies the requirements of the 
shared appointment book, so we will use 
it in this example and say little more 
about writing a server program* For 
examples of server-program implemen¬ 
tations other than the default somdsvr 
program, refer to the samples that are 
provided in the SOMobjects Toolkit. 

The final piece of a server implemen¬ 
tation is a class library for implementing 
the client-level classes. In this example, 
that would be the same DLL of appoint¬ 
ment-book objects we built in our last 
article. At that time, it wasn't dearly 
apparent why we built our classes into a 
DLL; we could have linked our client- 
level class implementations directly into 
the client program just as easily. Now, 
because we want the DSOM server pro¬ 
gram to load the appointment book 
classes dynamically on demand, we 
need to package the classes into a DLL 
DSOM can determine the DLL in which 
a class is implemented because of the fol¬ 
lowing line in the IDL files: 


dllname - "apptbk.dH"; 


In general, the SOM Frameworks all 
expect that class implementations can 
be dynamically loaded* Always build 
class libraries into a DLL. 

Now, think about how the client 
program might make use of this DSOM 
server* In the earlier client program, a 
new appointment book was created 
with the following call: 


AppointrnentBook apptBook = Appoint¬ 
ment BookNewO; 


In the new client program, we want 
to create our object at the server. To do 
this, we can use the somdCreateObj method 
on the Server object. This method is a 
way for a client program to create an 
object at the server. Unfortunately, for 
every client that invokes somdCreateObj, a 
new AppointmentBook will be created. This 
is hardly what we had in mind when we 
built the server. 

Ideally, a single appointment book is 


01 SQM.Scope SOMObject 5QMLINK somdCreateObj{AppointmentBookServer som- 
Self, 

02 
03 
04 

05 { 

06 
07 
08 

Self); 

09 
10 
11 
12 

13 /* 

14 

15 

16 

17 

hints); 

18 } 

19 _mjmber0fUsers++; 

20 obj = apptBook; 

a laid 

22 /* The object is not an AppointmentBook, create as always. 

23 ------- ----- */ 

24 obj = parent.somdCreateObjtsomSelf, ev, objclass, hints); 

25 } 

26 return (obj); 

27 } 

28 

29 SOM.Scope void SOMLINK somdDeleteObjOppointinentBookServer somSelf, 

30 Environment *ev, SOMObject 
somobj) 

31 { 

32 SOMObject obj = NULL; 

33 AppointmentBookServerData *somThi$ = 

34 AppointmentBookServerGetDataCsomSelf); 

35 AppointmentBookSer verMethodDebug{"AppointmentBookServ er", 

36 "somdDeleteObj 11 ); 

37 

38 if (somobj == .apptBook) { 

39 .numberOfUsers--; 

40 if LnumberQfUsers =- 0) { 

41 .apptBook = NULL; 

42 parent.sorndOeleteObj(somSelf, ev, somobj); 

43 > 

44 > else { 

45 parent.somdDeleteObjCsomSelf, ev, somobj); 

46 } 

47 } 

Figure 2 ’ The new Server object 


Environment *ev, 
Identifier objclass, 
string bints) 

SOMObject obj = NULL; 

AppointmentBookServerData *somThis = 

A ppointmentBookSer ve rGetData(som- 

AppointmentBookServerMethod0ebug(Appointment8ookServer 

somdCreateObj 11 ); 

if (strcmp{objdass, ,t AppointmentBook ,l )“0) { 

The object is an AppointmentBook, create a new one only 
if we haven't already created one. 

--- - - — - - - - */ 

if (_apptBook = NULL) { 

.apptBook = parent.somdCreateObj(somSelf, ev, objclass, 
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Client/Server 
Database Solutions 


It’s available now - ready to per 
form on your desktop, A new 
function-rich, 32-bit relational 
database you can really trust 
with your growing client/server 
network, your mission - critical 
data and your business. 

Introducing IBM DATABASE 2™ OS/2® 
(DB2/2™) from IBM Software Solutions, the 
birthplace of relational database technology, 
DB2/2 includes an industrial-strength DB 
engine that supports transaction management, 
concurrency control, security, integrity, and 
recovery functions. Designed to exploit the 
power and open architecture of OS/2, it also 
supports industry-standard SQL for developing 
portable applications. And it runs your DOS, 
DOS Windows™ and OS/2 
applications requiring 
online access. 

You can access data 
directly from DB2/2 on 
your desktop or from a 
DB2/2 server on your 
LAN, and with 



DISTRIBUTED DATABASE 
CONNECTION SERVICES/2,™ 
from DB2? SQL/DS,™ and OS/40CP 
databases as if they were on your desktop, too. 
This versatility can play a significant role in 
an Information Warehouse™ solution 
for your business. 

We’ve developed an 




exciting demo diskette to show 
you just how r well new DB2/2 
perforins - right on your desktop. Call us today 
for your free demo, or to order DB2/2: 
1-800-342-6672; or fax: 1-800-445-2426, 

In Canada, call 1-800-465-7999, ext. 850. 

An upgrade from OS/2 Extended Edition 
or Extended Services is also available. 


IBM, OS/2, DB2 and OS/400 are registered trademarks and DATABASE 2, DB2/2, DISTRIBUTED DATABASE CONNECTION SERVICES/2, 
SQL/DS and information Warehouse are trademarks of International Business Machines Corporation. Windows is a trademark of 
Microsoft Corporation. © 1993 IBM Corp 
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DLLOBJS = appt.obj mtg.obj ccall.obj apptbook.obj booksvr.obj \ 
initmod.obj 

booksvr.ih: booksvr.itfl 
booksvr.obj: booksvr.ih booksvr.c 


initmod.obj: initmod.c appt.h mtg.h ccall.h apptbook.h booksvr.h 


sample.obj: sample.c appt.h mtg.h ccall.h apptbook.h booksvr.h 
$(CC) $(CFLAGS) -c $*.c 


Figure 3. Changed and added lines of the make file 


01 impl: 

02 regimpl -A -i apptBookServer -v AppointmentBookServer 

03 regimpl -a -i apptBookServer -c Appointment 

04 regimpl -a -i apptBookServer -c Meeting 

05 regimpl -a -i apptBookServer -c ConferenceCall 

06 regimpl -a -i apptBookServer -c AppointmentBook 

Figured The regimpl utility 


shared among all client programs, 
regardless of which client started first. 
The server would free the object when the 
last client program no longer needs access 
to the appointment book. To do this, we'll 
participate in the creation and destruction 
of the appointment-book object. DSOM 
was designed with this in mind. To par¬ 
ticipate in the creation and destruction of 
objects at the server, we can create our 
own Server object derived from the 
DSOM supplied SOMDServer class. Because 
the class name of the Server object is deter¬ 
mined at run time, we can still use the 
generic, server program, somdsvr.exe. 

In our new implementation of a 
Server object, which we'll call an 
AppointmentBookServer, we want to inter¬ 
vene when a client attempts to create 
an AppointmentBook. To do this, we over¬ 
ride the somdCreateObj method of SOMD¬ 
Server. We also want to be involved 
when a client attempts to destroy an 


We’d like to say a word about 
client/server development. 

TESTING. 

You've chosen the platform, architecture, 
development tools, and application. Now’s 
the time to decide how you're going to test 
your client/server applications. 

The Softbridge Automated Test Facility (ATF) 
lets you fully automate regression testing, 
letting you test "often and early” in the 
development cycle. And that means lower 
costs, decreased time to release, and higher 
quality results. 

If you're building client/server (or stand¬ 
alone) applications under OS/2, Windows, 
or NT, you should be using ATF to test them. 
To learn more about ATF, call 800-955-9190. 


] Softbridge, Inc. 
617-576-2257 (Phone) 
617-864-7747 (FAX) 


ATF: The final 
word in testing. 
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• Add help to applications in minutes, not days 

• Designed for easy use by programmers and non- 
programmers 

• Generate C and Resource source files to add help to 
applications automatically 

• Import wordprocessing files, including WordPerfect, 
quickly and accurately 

• Create IPF tables from 1-2-3 and Excel spreadsheets 

• Preview IPF file output without compiling 

• Create all hypertext links automatically 

• Support for HFPS long file names 

• Create multimedia help and on-line documents with 
optional voice and animation modules 

• Compatible with both Netware and LAN Server 

• Includes complete on-line help and documentation 


Introductory Price: $95 
With Printed Manual: $125 

Perez Computing Services 
4725 Monte Vista Place 
Mount Vernon, WA 98273 


Orders and 
Information 
(206)42S-5025 

on CompuServe at 
70410,2416 


IPF EcMof and PCS are trademarks of Perez Computing Services 
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AppointmentBook* To do this, we override 
the somdDeleteQbj method. The IDL for 
the new Server object is contained in 
Figure 1. 

By now, you should be familiar with 
deriving a new class and overriding 
methods. In line 1 of Figure 1, we 
include the IDL definition of the SOMDServ- 
er class. In line 5, we name the new class 
and indicate that it is derived from SOMD- 
Server. In line 12, we specify that we plan 
to put the implementation of this new 
class in the same DLL as all our other 
classes. In lines 15 and 16, we declare 
some internal, instance data for the Server 
object and, in line 21, we override 
somlnit so that we can initialize the 
intance data when the Server object is 
instantiated. Finally, in lines 23 and 28, 
we override the somdCreateUbj and somd* 
DeleteObj methods so that we can partici¬ 
pate in the creation and destruction of 
objects in the server. 


We've purposely chosen to keep our 
Server object very simple. Our Server 
object, therefore, will only support one 
AppointmentBook object. The apptBook decla¬ 
ration in line 15 will be the one and only 
AppointmentBook that will exist at the server. 
It is possible, even desirable, to support 
more than a single AppointmentBook object 
in the server, however this would require 
that we maintain a table of AppointmentBook 
objects. For convenience, we've chosen 
the simpler implementation. 

The mmiberUf Users instance data in line 
16 of Figure 1 is used to keep track of 
how many client programs are currently 
using our one AppointmentBook object. We 
need to keep track of this information so 
we know when it is possible to free the 
Appointment Book. When the counter is 
decremented to zero in the somdDeleteObj 
method, we'll free the AppointmentBook. 
While the counter remains one or more, 
we'll neither create nor free our single 


appointment book, but simply increment 
or decrement the number of users* 

The implemention of our new Server 
object is shown in Figure 2* 

To save space, we do not show the 
implementation of the somlnit method, 
somlnit simply initializes the apptBook to 
NULL and sets the numberOfUsers to zero. 

In line 12 of the somdCreateUbj method, 
a check is made to see if the object about 
to be created has a class name equal to 
AppointmentBook, If it does and the apptBook 
instance data is NULL, a new Appointment- 
Book object is created in line 17 by invok¬ 
ing the parent implementation of the 
somdCreateUbj method. Whether a new 
AppointmentBook object is created or the 
existing AppointmentBook object is used, the 
number of users of the book is incre¬ 
mented in line 19* 

The somdCreateUbj method will also be 
used to create the other objects in our 
server process. This includes the Meeting 


OS 2 TREE™ 

See your entire system graphically at a glance! 
■What XTREE GOLD is to DOS and More! 
And What Norton Commander Missed" 

• Completely programmable: every fiincrion/key can be 
customized! 

• Display your tree structure for all system and LAN disks 
concurrently ! 

• Manipulate your files, directories, entire disks 
and/or entire system! 

• HPFS fully supported 

• Pop-up list of files for any directory 

• Edit/browse file(s) using any EDITOR or PROGRAM! 

• Extensive FILE Search and Tree directory search 
capabilities make locating files and/or data easy. 

• Upload/download files between mainframe and PC 

• Secure delete (sensitive files wiped clean) 

Intro Price: $79 99 
Professional Version: $249*99 
Limited time special $150,00 
Network Licenses Available 
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7640 Provincial Dr., Suite 213, McLean, VA 22102 
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dbfLIB 
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and ConferenceCall objects contained in 
the AppointmentBook* When the object to 
be created is one of these other objects, it 
is created the normal way, in line 24, by 
simply invoking the parent implementa¬ 
tion of the somdCreateObj method. We 
don't need to handle these types of 
objects in a special way, like the Appoint- 
mentBook object; because they are con¬ 
tained within the one AppointmentBook 


object. 

When an object is to be destroyed with 
somdDeleteDbj, we first check to see if it is 
our AppoifitmentBook object. This check is 
made in line 38 by comparing the given 
object to the value of apptBook. We only 
want to free the AppointmentBook if there are 
no other current users of the book. This 
check is made in line 40. When there are 
no other users, the apptBook is nulled so 


that the next invocation of somdCreateObj 
for an AppointmentBook will create a new 
one. Then, the AppointmentBook object is 
freed in line 42 by invoking the parent 
implementation of somdDeleteObj. 

When the object to be destroyed is 
anything other than our AppointmentBook 
object, it is destroyed in the normal way 
in line 45 by invoking the parent imple¬ 
mentation of sorodDeleteObj. 

COMPLETING THE IMPLEMENTATION 

We are now prepared to complete the 
implementation of our DSOM server. All 
that remains is for us to package the new 
AppointmentBookSener class into our 
dynamically loadable class library 
(APPTBfCDLL) and "install" our DSOM 
server implementation. 

To add the new class to the APPT- 
BK-DLL, we need to make a couple 
minor changes to the make file shown in 
our previous article, add a line to the 
SOHInitHodule procedure, and add the 
class externals to the APPTBK.DEF file. 
The changed and added lines of the 
make file are shown in Figure 3. Note 
the additions to build and use 
booksvr.obj, booksvr.h, and booksvr.ih. 

The only change required to SQHInit- 
Module is the addition of the following 
line to the body of the function: 

AppointnentBookServerNeuClass{0,0); 

and the addition of the class header file 
at the begining of the C file: 

tinclude <booksvr.h> 

The additions to the EXPORTS portion 
of the APPTBK.DEF file are: 

AppointmentBookServerCQassData 
Appointmen tBookSe r ve rQa ssOata 
AppoirtmentBookServerNeuQass 

The procedure for installing a DSOM 
server involves more than simply copy¬ 
ing the server program and class library 
into the PATH and LBPATH. We must also: 

1. Set some environment variables used 
by DSOM at run time. 

2. Register the classes we plan to access 
from other processes in a database 


SINGLE KEY-STROKE 
SCREEN PRINTING 
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CLIPBOARD 

VIEWER 


SCREEN 
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# Quality Color or Black & White copies of color Desktop Images. 

# Copy any portion of any image on the Desktop. 

# Screen Saver prevents monitor burn-in. 

# Date & Time Display for Time-Stamping images. 

# LAN installable. Complete support for LAN attached printers. 
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# The most stable and reliable product available. 
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THE LEADER: PrntScrn™ Screen Image Utility for OS/2 
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known as the interface repository. 

3. Register a description of the server 
implementation in a database known 
as the implementation repository. 
The following is a description of the 
environment variables that DSOM relies 
upon: 

• SOHIR is a list of files, delimited by semi¬ 

colons, that together make up the 
interface repository. This variable is 
set when you install DSOM. 

• SOMDDIR is the name of the directory 
where the implementation repository 
is stored. 

• USER identifies the user ID of a DSOM 

client application. 

• HOSTNAME identifies the name of the 
machine on which DSOM is running. 
If the client and server are running on 
the same machine this variable may 
be set to any value. We typically set it 
to localbost in this situation. 

• SOMSOCKETS identifies the name of the 
class used to implement sockets for 
DSOM. If using TCP/IP, set this to 
TCPIPSockets. This variable is only 
required if you are using the SOMob- 
jects Workgroup Enabler. 

For DSOM to handle the remote 
method invocations that will be made on 
our library of appointment book classes, 
it must know every detail about the 
methods in the class library. It must 
know the names of the methods of the 
classes, the return types of the methods, 
the number and types of parameters the 
methods take, and so on. This informa¬ 
tion is stored in the interface repository. 
The interface repository is built and 
maintained by the SOM compiler when 
we include the -u switch as we invoke 
the compiler. 

The implementation repository con¬ 
tains information about a DSOM server 
implementation. This includes the name 
of the program that implements the serv¬ 
er, a user-friendly alias that can be used 
to refer to the server, the class name of 
DSOM Server object, and the names of 
the classes implemented by the server. 
DSOM uses the implementation resposi- 
tory to find and, if necessary, start a serv¬ 
er program. 

DSOM provides a utility program, 
named regimpl.exe, to build the imple¬ 


mentation repository. Since we are using 
the DSOM-supplied, generic server pro¬ 
gram, somdsvr.exe, for our appointment- 
book server program, we just need to 
specify the name of our server, the class 
name of our Server object, and the classes 
that it implements. Our use of the regimpl 
utility is shown in Figure 4. Line 2 adds a 
new implementation named apptBookServ- 
er to the implementation repository. 


Client programs will refer to the DSOM 
server with this alias name. In the same 
line, we specify that the class name of the 
Server object is AppointmentBookServer. By 
specifying the name of the Server object, 
DSOM knows to use our class rather the 
the default SOMDServer class. Lines 3 
through 6 specify the classes our server 
supports. 

After one final step that must be com- 


The GammaTech 
Utilities are 
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your OS/2 system. 
These utilities provide 
the ability to perform 
vital maintenance 
and recovery 
operations easily 
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technical knowledge. 
Use GammaTech 
Utilities for your 
critical data or you 
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pleted on the server machine, our DSOM 
server will be ready for use, A process 
called the DSOM daemon must be start¬ 
ed, The DSOM daemon is used to con¬ 
nect DSOM client processes to a DSOM 
server process and start DSOM servers 
automatically, ii necessary. At the com¬ 
mand prompt or in the STARTUP.CMD, 
enter the command: 

start somdd 

When a client program attempts to 
use our server, named apptBookServer, the 
DSOM daemon will consult the imple¬ 
mentation repository to determine the 
name of the server program to run. 
Because we didn't specify one, it will 
start the default server program, 
somdsvr.e*e. 

All that remains to complete the 
example are the changes to our earlier 
client program, which are required to 
use the DSOM server. In the previous 
client program, we created the appoint¬ 
ment book with the following line: 

apptBook - AppointmentBookNeuO; 

To create the appointment book in 
the server, we replace this line with the 
following lines: 

SQMD_Init(ev); 

server = _somdFindServerByName 

(S0HD_0bjectHgr ,ev, "apptBookServer 11 ); 
apptBook - _soffldCreateQbj(server,ev, 

"AppointmentBook", NULL); 

The first line initializes the DSOM 
run-time environment by calling 
SOHD^Init During initialization, an object 
called the DSOM Object Manager is created. 
The Object Manager object is stored in the 
global variable SOMD_ObjectH£r, The Object 
Manager provides a variety of useful func¬ 
tions for client programs including 
methods for finding Server objects. 

In the next line, we use the Object Man¬ 
ager object to find our server, named 
apptBookServer. It is important to under¬ 
stand that the Server object returned by 
the somdFindServerByNaitie method is not 
actually the same object that exists in the 
server process. What is returned to the 


client is an object that has the same inter¬ 
face as the actual object in the server but 
an implementation provided by DSOM. 
DSOM calls these special objects "proxy 
objects/' When we invoke a method on a 
proxy object, the DSOM implementation 
for that object packages-up the parame¬ 
ters we have passed to the method into a 
message. The message is then forwarded 
to the server process where the real 
object exists. The server's main program 
wakes-up when it receives this message 
and passes it to the server's SOMOA 
object for resolution into a real-method 
call on the real object, 

DSOM builds a client proxy object 
every time it returns an object from a 
server. Therefore, just as the server object 
returned from the call to sondFindServerBy- 
Name is a proxy object, so is the apptBook 
object returned by the call to somdCreateObj 
in the next line of our program. Keep in 
mind that the somdCreateQbj method has 
actually been executed in the server 
process. The output of the method is the 
AppointmentBook object. When the output 
of a method invoked on a proxy object is 
an object, DSOM will convert it into a 
client proxy object automatically and 
transparently. 

The next change to the client program 
is how we create the appointment 
objects, which will be added to the 
appointment book. In the standalone 
client, we used the following to create a 
new Meeting object: 

appt = MeetingNewQ; 

In the DSOM client, we create the 
Meeting object just as we did the Appoint- 
mentBook object, with somdCreateObj; 

appt - ^somdCreateObjfsmer, ev, 
"Meeting", NULL); 

Conferee ceCaH objects are created in 
the same way* 

A proxy object can be used just like a 
normal object and, in fact, can be used 
as a parameter in method invocations on 
other proxy objects. For example, in the 
following line, we use the appt proxy as 
an argument in the addAppointinent 
method invoked on the apptBook proxy 


object: 

id = _addAppointment(apptBook, ev, 
appt); 

When a proxy object is passed to a 
remote object, the server locates the real 
object and uses it instead of the proxy 
when the method is invoked. 

Most interactions with remote objects 
are the same as with local objects. How¬ 
ever, client programs must perform 
some memory management when they 
invoke methods on remote objects that 
return allocated space such as strings, 
sequences, arrays, and objects. In the fol¬ 
lowing line, the bufferize method is 
invoked to return a formatted string, 
which can be displayed to show the con¬ 
tents of an Appointment object: 

buffer - _bufferize(sequenceElement 
(apptList,!), ev); 

Recall that the bufferize method 
returns a string that has been allocated 
within the Appointment object. Because 
the pointer is only valid within the 
address space of the server process, it 
can't be returned to the client program. 
In this case, DSOM allocates equivalent 
space within the client process. 

This storage must be managed by 
the client program. When the buffer 
returned by bufferize is no longer need¬ 
ed, it must be freed by calling the 
QRBfree function: 

QRBfreefbuffer); 

A similar, memory-management 
issue occurs during the invocation of 
the getDaysAppointments method: 

apptList - _getOaysAppointments(appt¬ 
Book, ev, year, month, day); 

This method returns the sequence 
apptList that contains Appointment 
objects for the given day. Recall that 
a sequence is a structure that con¬ 
tains a buffer field, which is a pointer 
to an array. Like the bufferize 
method, this method returns a point¬ 
er to an array allocated within the 
object. Therefore, we must free the 
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array: 

DRBfree(apptLxst..buffer); 

Before we can free the array, how¬ 
ever, we need to free the objects con¬ 
tained within the array. This is because 
the objects returned in the sequence are 
proxy objects. These objects were creat¬ 
ed automatically when DSOM returned 
the results of the method invocation. 
These objects can be freed with the fol¬ 
lowing code: 

for (i=Q; i < sequenceLength(appt 
List); i++) 

_somdProxyFree($equenceELement(apptLLs 
t,i), ev); 

If a DSOM client program ignores 
these memory-management responsi¬ 
bilities, eventually it will run out of free 
memory. 

To terminate the client program, we 
replace the somFree method call with 
these three lines: 

_somdDeleteObj(server, ev, apptBook); 
_somdProxyFree(apptBook, ev); 

S0MD_Uninit(ev); 

In the first line, the AppointmentBook- 
Server object is instructed to destroy its 
Appointment Book object. Recall that our 
overridden implementation of the somd* 
DeleteObj method will only free the appt- 
Book if there are currenly no other 
clients using the AppointmentBook. The 
method call also reduces the number of 
users of the AppointmentBook by one. 

somdOeLeteObj takes care of the appt- 
Book object at the server, however we 
still need to free the local, proxy object. 
This is accomplished with the call to 
sorndProxyFree. 

Finally, before terminating the 
program, a DSOM client program 
must return any resources used by 
DSOM to the operating system. This 
is done by uninitializing the DSOM 
run time with a call to SOHDJniniL 
DSOM client programs, if possible, 
should include a call to SOMDJninit 
within an existlist handler. 

While this example application is 
quite simple, the problems that it 
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illustrates and solves are very realis¬ 
tic. The SOMobjects Toolkit and 
DSOM offer opportunities to build 
new and powerful, object-oriented 
applications and is available now for 
both OS/2 and AIX, In the future, 
watch for SOM and DSOM to be 
available for Windows applications* 
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Object-Oriented 


The user interface class library of the IBM C Set-hh compiler revises and simplifies the programming interface to 
the popular notebook control. Instead of mastering various Presentation Manager messages and notifications, 
developers creating 32-bit OS/2 applications with the new interface use simple objects to organize, manipulate, 
and present information. This article does not attempt to explain every method of the new interface but instead 
gives an in-depth tour of the most-used types of functions. By BRAD BROYLES 


Building a Notebook with IBM 
C Set ++ Objects 


r he notebook control introduced in IBM's 
OS/2 2.0 (and in the IBM SAA Common 
User Access Controls Library for OS/2 
1.3 and Windows 3.x) is a very popular and 
easy-to-use way of organizing data into a for¬ 
mat that is simple for users to understand and 
manipulate. In addition to providing pages that 
allow developers to organize and separate 
information into different categories, the note¬ 
book control supplies page tabs that users can 
manipulate to move among the different cate¬ 
gories with either a pointing device or the key¬ 
board. By supplying objects that represent the 
notebook control and can be used as keys for 
inserting and modifying notebook pages, the 
user interface class library of the C Set ++ com¬ 
piler simplifies the coding interface and allows 
developers to approach the notebook control 
from an object-oriented point of view. 

CREATING A NOTEBOOK OBJECT 
The INotebook Class. The INotebook class is the 
heart of the notebook control. An instance of the 
INotebook class must be created before any pages 
can be inserted into the notebook. The INotebook 
class has three constructors, any of which can 
be used for creating notebook objects. The first 
constructor provided by the class supplies a 
default rectangle and notebook style so that 
only a control ID, parent window, and owner 
window have to be specified, as shown in 
Figure 1. 

ID.N0TEB00K is the control ID of the created 
notebook; pParent is a pointer to the Window 


object, which will be the parent of the notebook 
window; and pOwner is another Window pointer 
that points to the window, which will be the 
owner of the notebook (when these two point¬ 
ers are the same, there is another INotebook con¬ 
structor that takes one pointer and assumes it 
points to the parent and the owner). 

Since neither a rectangle nor a notebook style 
was specified, this constructor will provide a 
default sizing rectangle and the default 
notebook style (a visible notebook with solid 
binding on the left, back pages drawn on the 
bottom right, square page tabs with major tabs 
on the right, left-justified status text, and cen¬ 
tered tab text). If it was necessary to specify a 
particular rectangle for the notebook's initial 
size or a special notebook style, those parame¬ 
ters could be added to the constructor call. The 
size and style of the INotebook instance can be 
changed after creation with the setStyle and 
sizeTo methods, which INotebook inherits from 
Window, one of its superclasses. However, a more 
direct way of altering the notebook's appear¬ 
ance is to use the style functions that the INote¬ 
book class provides. For example, the setBinding 
method provides an interface for changing the 
notebook's binding style, and you can use the 
Notebook's binding method to query the current 
binding style of the notebook (INotebook 
enumerations are used to define the different 
types of bindings). The code in Figure 2 uses the 
INotebook style methods to change the notebook 
object created previously from the default style 
to a spiral-bound notebook with polygon page 
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tabs, major tabs on the bottom, and back pages 
drawn to the bottom right, 

PAGE MANIPULATION 
Inserting Notebook Pages. Typically, each page of 
a notebook displays a window or dialogue 
object, which in turn contains other control 
objects such as text, entry fields, or push but¬ 
tons. The notebook object contains no pages 
when it is created (although the drawn back 
pages make it appear this way). The PageSettings 
object is used to specify the features of a page 
when the page is added to the notebook. For 
example, the PageSettings object indicates 
whether or not the page should have a major 
tab, minor tab, or status line on it; what tab text, 
status text, or user data should be associated 
with the page; and if the page is auto-sizing (if 
so, the window or dialogue displayed on the 
page will be automatically sized to fit; if not, 
the application will be responsible for handling 
the size). The values in a PageSettings object are 
used only when the page is added to the note¬ 
book; changing a PageSettings object after a page 
has been added has no effect on the page. 

Adding a page is a function of the notebook, 
and the INotebook class provides several meth¬ 
ods for adding pages. Each one takes a PageSet¬ 
tings object that defines the attributes of the 
page to be added and a pointer to the window 
or dialogue object, which should be displayed 
on the page after it is added to the notebook (if 
this pointer is null, then an empty page will be 
added; empty pages can still have status lines 
and a tab but do not have dialogues displayed 
on them). Some of the methods take an addi¬ 
tional parameter for adding pages before or 
after another existing page. 

The code in Figure 3 illustrates how a Page- 
Settings object can be used. One PageSettings 
object will be used to add three pages to the 
notebook that was previously created. In this 
example, there are three dialogues loaded from 
the application's user resource library and 
added to the notebook (these dialogues have 
successive IDs). 

The PageSettings object is created with the 
combined attributes of autoPageSize and majorTab; 
all the pages added with this PageSettings object 
will handle sizing themselves and have major 


/* Create a new INotebook abject and save a pointer to it */ 
pNotebook = new INotebook(ID_NOTEBOOK, pParenl, pOwner); 

Figure 1. Using an INot ebook constructor 


/* set the binding, tab shape, and orientation of the notebook */ 

p N o te bo o k-> set Bin ding (IN ot ebook;:spir al); 
pNotebook->setTabShape (INotebook::polygon); 
pNotebook->setOrientation (INotebook::backpagesRightTabsBottom); 


Figure 2. Altering an INotebook objects appearance 


long i = 0; 

/* create an IPageSettings object with the page-sizing and major 
tab attributes */ 

IN o teboo k::PageSettings page Se ttin gs 

(INotebook::PageSettings::autoPageSize I 
INotebook::PageSettings::majorTab); 
for (; i < 3; i++) 

{ 

pDialogs [i] - new IFrameWindow (XD.FIRSTPAGE + i); //load the 
dialog 

pageSettings.setTabText (IString (i + 1)); //set tab 

text 

pNotebook->addlastPage (pageSettings, pDialogs [i]); //add to 
notebook 
> 

Figure 3: Inserting notebook p3g$s 

tabs, inside the for loop, after the dialogue is 
loaded, the setTabText method is used to define 
tab text for the PageSettings object. This tab text 
will be passed to the notebook when the page is 
added. After the tab text is set, the notebook's 
addlastPage method is called, a new page is 
added to the notebook, the attributes and the 
tab text that were previously set in the PageSet¬ 
tings object are transferred to the new page, and 
the dialogue currently referenced in the pDialogs 
array is displayed on the page. Once the page 
has been added, the PageSettings object can be 
changed without affecting the new notebook 
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page—there is no connection main¬ 
tained between the two. This allows 
the tab text in the PageSettings object 
to be changed the next time through 
the loop without affecting the page 
that was added in the previous itera¬ 
tion. After the three pages have been 
added, the notebook looks like 
Figure 4. 

Altering Notebook Pages. Since 
there is no linkage between the Page- 
Settings object and a page after it is 
added to the notebook, the INotebook 
class provides methods for altering 
pages. To identify which page in the 
notebook is to be changed, use the 
IPageHandle object. In the same way 
that handles in Presentation Manager 
are used to identify objects like 
windows, IPageHandle objects are used 
to identify individual pages in a 
notebook object. 

The INotebook class returns IPage¬ 
Handle objects from various query 
methods such as firstPage {returns an 
IPageHandle referencing the first page 
of the notebook), lastPage (returns an 
IPageHandle referencing the last page 
of the notebook), and topPage {returns 
an IPageHandle referencing the page 
currently visible). Similarly, if an 
instance of IPageHandle is already 
available, the nextPage and previousPage 
methods can be used for obtaining an 
IPageHandle for the page following or 
preceding the page referenced by the 
existing IPageHandle, 

In the code sample in Figure 5, an 
IPageHandle object referencing the last 
page of the notebook is returned by 
the notebook and used to change the 
tab text of that page. 

Traversing Notebook Pages . The 
pages of a notebook can be traversed 
by using IPageHandle objects, but the 
INotebook class provides a Cursor class 
that can do the job as well (and pre¬ 
serves the Cursor interface that is pro¬ 
vided by other classes in the user 
interface class library). A Cursor 
object can be created by specifying 
the object the cursor will iterate 
over—in this case, the notebook 
itself. Then a Cursor method, like set- 
ToFirst, can be used to initialize the 



Figure 4. The notebook after three pages have been added 


/* get a handle to the last notebook page and change its tab text */ 
IPageHandle lastPageHandle - pNotebook->las±Page(); 
pNotebook->setTabText (lastPageHandLe, "Last"); 

Figure 5. Using the IPageHandle class 


f* create a cursor for iterating over the pages of the notebook*/ 
INotebook::Cursor notebookCursor (*pNotebook); 
for (notebookCursor. setToFirstO; // set the cursor to first page 
notebookCursor.isValidO; // keep going if cursor is valid 

notebookCursor.setToNextO) // move the cursor to next page 

{ 

/* turn to the page indicated by the notebook cursor */ 
pNotebook->turnToPage (notebookCursor ); 

} 

Figure 6 ; Using a notebook cursor 


/* remove the page which the notebook indicates as its first page */ 
pNotebook->removePage (pNotebook->firstPage()); 

Figure 7. Removing a page 


Cursor object to reference the first 
page of the notebook. As long as the 
cursor is in a valid state, it can be 
used to traverse the notebook pages 
one at a time. The code snippet in 
Figure 6 shows a Cursor object being 
created and used to display each 
notebook page in succession. 

In Figure 6, the first line creates an 


object of type INotebook: 'Cursor, which 
will iterate over the notebook point¬ 
ed to by the pNotebook variable. In the 
for loop, the notebook cursor is ini¬ 
tialized to the first page in the note¬ 
book with the setToFirst method. 
Each time through the loop, the 
isValid method is used to test the 
notebook cursor; when it has reached 
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the end of the notebook, the note¬ 
book cursor will no longer be valid, 
and the isValid test will halt the loop. 
After each loop iteration, the setloNext 
method causes the notebook cursor 
to reference the next page of the note¬ 
book. The turnToPage method used in 
the body of the loop causes the note¬ 
book to bring a specified page to the 
top, so that it is displayed on the 
screen. Either an IPageHandle object or 
an INotebook::Cursor object can be used 
as the argument for turnToPage. 

Since INotebook::Cursor objects deal 
with IPageHandle objects, it is very 
easy to obtain one from the other. 
The INotebook::Cursor class returns 
IPageHandle objects from its first, last, 
next, previous, and current methods. 
An IPageHandle object can be sent to a 
notebook cursor with the setCurrent 
method to make a cursor reference 
the same page as the IPageHandle 
object. 

Removing Notebook Pages. Once the 
notebook has been filled with pages, 
eventually some (or all) of those 
pages will need to be removed. The 
INotebook class provides several meth¬ 
ods for removing pages, either one at 
a time or in groups. The removeDlPages 
method is self-explanatory, and the 
removePage method can take either an 
INotebook “Cursor object or an IPageHan¬ 
dle object as a reference to the page 
to be removed. The removeTabSection 
method also can use either an Bote- 
book: :Cursor or IPageHandle object, but 
its behavior is more complex. If the 
referenced page has a major tab, then 
that page and all following pages up 
to the next major tab page will be 
deleted. If the referenced page has a 
minor tab, then that page and all sub¬ 
sequent pages up to the next page 
with any tab will be removed. (If the 
referenced page has no tab at all, 
then no pages are deleted.) 

An IPageHandle object referencing 
the first page of the notebook is 
implicitly created and used to delete 
the notebook's first page in Figure 7's 
line of code. 

Counting Notebook Pages . The INote¬ 
book class also provides methods for 


/4444444444444444444444444444444444*44444*44444444444444444444444444444/ 

/* Class definition of HainWindow. It is both an IFrameWindoy and an IPage¬ 
Handler (a frame uindou that handles page events) 4/ 

/4444444444444444444444444444*4444444444*4444*4444444444444444444444444/ 

class MainWindoy : public IFrameWindoy, public IPageHandler 

{ 

public: 

HainVindou(unsigned long windovld); 

"MainWindoy (); 

protected: 

/* these are IPageHandler events that HainWindow is overriding */ 
virtual Boolean select { IPageSelectEvent ftevent ); 
virtual Boolean drawTab ( INotebookDrawItemEvent ftevent }; 

private: 

INotebook* pNotebook; 

IFrameWindoy* pDialogs [3]; 

>; 

/4444444444444444444444*4444444444444444444444444444*444444444444444444/ 

/* HainWindoy constructor */ 

/44444444444*4444444444444444444*4*444444*444444444444444444444444*4444/ 

HainWindoy :: MainWindov (unsigned long uindould) 

: IFrameWindoy (yindoyld) 

< 

IWindou* pQvner - this; 

IWindou* pParent = this; 

/* create a new INotebook object and save a pointer to it */ 
pNotebook = new INotebook(IDJOTEBOQK, pParent, pOyner); 

/* set up HainWindoy as a handler of page events 4/ 

IPageHandler: :JiancHeEventsFor (pNotebook); 

/* set the binding, tab shape, and orientation of the notebook */ 
pNotebook->setBinding (INotebook::spiral); 
pNotebook->setTabShape (INotebook::polygon); 
pNotebook->setOrientation (INotebook::backpagesRightTabsBottom); 

long i = 0; 

/4 create an PageSettings object yith the page-sizing and */ 

A major tab attributes */ 

INotebook::PageSettings pageSettings 

(INotebook::PageSettings::autoPageSize I 
INotebook::PageSettings::majorIab 
); 

for {; i < 3; i++) 

{ 

pDialogs [i] = new IFrameWindoy (ID_FIR5TPAGE + i); //load the dialog 
pageSettings,setTabText (IString (i + 1)); //set tab text 


Figure 8 , Skeleton class definition, constructor and destructor for a window that acts as a page 
handler (continued on page 60) 
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using information about the number 
of pages in the notebook. A Boolean 
value is returned from the isEffipty 
method, which indicates whether or 
not the notebook has any pages in it. 
The totalPages and pagesToEnd methods 
return the number of total pages in 
the notebook and the number of 
pages from a specified page (again, 
using either an IPageHandle object or 
an INotebook::Cursor object) to the end 
of the notebook (including the speci¬ 
fied page). 

The pagesToHajorTab and pagesToHi- 
norTab methods also can use either an 
IPageHandle or an INotebook:'Cursor as 
an argument, but these methods only 
return the number of pages between 
the specified page up and the next 
page with a major tab or minor tab, 
respectively. 


MORE ADVANCED TOPICS 
Handling Notebook Events . The user 
interface class library has an exten¬ 
sive system of events and event han¬ 
dlers (the objects that handle the var¬ 
ious events). Included in this archi¬ 
tecture are several events that are 
particular to the notebook. These are 
called page events, and they notify 
their handlers of events like notebook 
pages being selected or deleted, the 
notebook window being resized, help 
being requested on a page tab, and a 
page tab being drawn. In order to be 
notified of these events, developers 
must use the IPageHandler class (some¬ 
times the owner window of the 
notebook is used as a subclass of 
IPageHandler). 

Suppose, for example, a notebook 
should beep whenever the last page of 
the notebook is displayed. If the note¬ 
book is the client area of the main 
window, then the main window could 
he a subclass of IPageHandler as well as 
IFrameWindow (and whatever other class¬ 
es or handlers it is using). After the 
notebook has been created and insert¬ 
ed into the client area (usually by the 
IFrajneWindow method, setClient), the 
main window can use the IPageHan¬ 
dler: :handleEventsFor method to indi¬ 
cate that it will be handling page 


pNotebook->addLastPage (pageSettings, pDialogs [i]); //add to notebook 

> 

/* make the notebook the client area of MainWindow */ 
setCLient(pNotebook); 

setFocusQ; 

shovO; 

} 

/**********************************************************************/ 
/* MainHindow destructor */ 

/**********************************************************************/ 
HainWindou :i "HainHindow () 

{ 

/* stop handling the page events of the notebook */ 

IPageHandler::stopHandlingEventsFor (pNotebook); 

long i = 0; 

for (; i c 3; i++) 

{ 

delete (pDialogs [i]); // free space allocated for dialogs 
> 

delete pNotebook; // free space allocated for notebook} 


Figure 5. Skeleton class definition, constructor and destructor fora window that acts as a page 
handler (continued from page 58} 


events. As a result of this call, particu¬ 
lar methods in the IPageHandler class 
will be called using IPageEvent objects 
as parameters. The main window can 
then intercept individual events by 
defining and implementing those 
methods (since the main window is an 
IPageHandler subclass). Similarly, when 
the main window no longer needs to 
intercept page events, it should call 
the IPageHandler::stopHandlingEventsFor 
method. Figure 8 shows a skeleton 
class definition, constructor, and 
destructor for a main window that 
acts as a page event handler and 
uses page events to generate the last 
page beep. 

The class definition defines Hain- 
Uindov as a subclass of both IFranoWin- 
dou and IPageHandler. In its construc¬ 
tor, HainVindotf creates a notebook 
(pNotebook, private HainWindow data, is a 
pointer to an INotebook object), adds 
pages, and uses setClient (an 
IFrameWindov method) to put the INote¬ 
book object in its client area. MainWindow 


uses the IPageHandler: :handleEventsFor 
method to establish itself as a han¬ 
dler of the page events generated by 
the notebook object referenced by 
pNotebook. Anytime a page event is 
generated by that notebook object, 
the page event will be sent to HainWin- 
dov, and any page events that MainWirr 
do* does not handle will be passed to 
the default handler, the IPageHandler 
class itself. 

Also in the HainWindow class defini¬ 
tion are declarations of the IPageHan¬ 
dler methods, which HainVindou 
intends to override. These methods 
are listed in the protected section of 
the HainUindow class definition and 
have Boolean return codes; the 
Boolean values returned from these 
methods indicate whether processing 
of the event should stop with this 
handler (true) or whether processing 
should continue with any other han¬ 
dlers registered (false). The select 
method is called when a notebook 
page is selected. 
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INTRODUCING OS/2 MAGAZINE 
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Boolean MainWindov :: drawTab (BlotebookOrawItemEventi event) 
/im*******************************************************************/ 
/* This method will be called when a page tab is to be drawn. */ 

/i*********************************************************************/ 

{ 

POINTL pCenter = event.itemRect().center0,asPOINTL(); // rect center 
ARCFARAMS arcp * {i, i, 0, 0}; //arc parameters 

HPS hps = (HPS) event.itemPresSpaceHandleO; // presentation space 

long j, i, 

drArray [4] = {CLRJLUE, CLRJED, CLRJREEN, CLR^VELLOW}; 

GpiSetCurrentPosition (hps, AipCenter); 

GpiSetUrcParams (hps, fiarcp); 

for (i = 0, j = 20; j >« 5; j -= 5, i++) 

{ 

GpiSetColor (bps, dr Array [i]); // change color 

GpiFuHArc (hps, DRO 0UTLINEFILL, MAKEFIXED (j s 0)); // draw circle 

> 

return (true); // 


In turn, the MainVindow destructor 
must call the IPageHandler::stopHan- 
dlingEventsFor method so that MainWin- 
dow will stop receiving page events 
generated by the notebook object. (In 
this example, identifying handleEvents- 
For and stopHandlingEventsFor as IPage¬ 
Handler methods is not really neces¬ 
sary, since MainWindow doesn't subclass 
any other handlers. However, if Rain- 
Window did subclass other handlers, it 
is much clearer to identify which ver¬ 
sions of handleEventsFor and stopHan¬ 
dlingEventsFor are being called.) 

The Rain Window:: select method 
overrides the default handling of the 
page selection event provided in the 
IPageHandler superclass. The IPageSe- 
lectEvent object that is passed to the 
select method has methods of its own 
that can provide IPageHandle objects 
referencing the selected notebook 
page or the previously selected note¬ 
book page as well as a pointer to the 
IHotebook instance where the selection 
event was generated. In the example, 
the pageHandle method is invoked to 
get a reference to the selected page, 
and that IPageHandle is compared 
against the IPageHandle returned from 
INotebook's lastPage method to deter¬ 
mine if the last page of the notebook 
is the selected page. If so, a beep is 
generated. Finally, false is returned 
to signal that processing should 
continue with any other handlers. 
This is a very simple use of the select 
method, but with the various pieces 
of information provided by the 
IPageSelectEvent object, it's easy to see 
how simple it is to implement vari¬ 
ous behaviors like changing the tab 
text status text of selected pages, or 
even displaying a page other than the 
one selected! The other page events— 
like help, remove, and resize—all work 
similarly. 

Drawing Notebook Tabs . A fun 

event to handle is the drawing of 
notebook tabs rather than defining 
text or bitmaps for them. Handling 
tab-drawing events Is similar to han¬ 
dling other page events, although 
some different information is 
required from the INotebookDrawIte- 


Figure 9, Handling the tab-drawing event 

mEvent object that is passed on the 
drawTab method. 

Like the other page event classes, 
INotebookDrawItemEvent has a method 
for returning an IPageHandle object ref¬ 
erencing the page involved in the 
event (in this case, the page with the 
tab to be drawn). In addition, INote¬ 
bookDrawItemEvent inherits other meth¬ 
ods from its superclass, IDrawItemEvent, 
for obtaining the presentation space 


no more processing of this event 


to use when drawing and the rectan¬ 
gle that bounds the tab's drawing 
area. The example in Figure 9 shows 
some simple drawing in page tabs. 

In the Figure 9 sample, the item- 
PresSpaceHandle and itemRect methods 
that INotebookDrawItemEvent Inherits 
from IDrawItemEvent are used to 
obtain, respectively, the presentation 
space for drawing and the rectangle 
in which to draw (the rectangle rep- 



Figure 10. The notebook after the tab drawings 
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resents the area of the page tab). The 
tab rectangle is used to find the cen¬ 
ter of the drawing area, and the pre¬ 
sentation space handle is used to set 
the current position to the center of 
the drawing rectangle and then to 
draw overlapping circles on the tab. If 
different drawings are needed on dif¬ 
ferent tabs, INotebookDravItemEvent's page 
method can be used to find out which 
page's tab is being drawn. Finally, 
true is returned to indicate that this 
IPageHandler object has done the draw¬ 
ing, and the draw tab event does not 
need to be processed by any other 
handlers. 

Figure 10 contains the results 
results of the tab drawings. 

CONCLUSION 

The interface to the notebook control 
provided by the user interface class 
library is very powerful and compre¬ 
hensive. Familiar Presentation Man¬ 
ager functions and styles are fully 
available, and event processing is 
simple to implement through the 
user interface class library's extensive 
handler-and-event architecture. The 
behavior of the INotebook object and 
related objects can even be extended 
through the subclassing and overrid¬ 
ing capabilities of the C Set ++ com¬ 
piler. In summary, the notebook con¬ 
trol of the user interface class library 
is just as powerful—and even more 
extendible—than under Presentation 
Manager alone. 
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This is the first of a series of articles in which we develop a replacement list box with enhanced capabilities. 


BY MARK A. BENGE and MATT SMITH 


A List Box 
Replacement 



Mark A Benge 



r his month, we will explain how to write a 
replacement of the OS/2 Presentation Man¬ 
ager list box* This replacement wiO duplicate 
all of the existing functionality, so you can use it in 
place of the current list box. One very significant 
enhancement will be the removal of the memory 
limitation that plagues the current list box. We 
cannot show the entire source code for the list box 
here due to space limitations, but you can obtain it 
from resources listed in the References section at 
the end of the article. 

The current, list-box design within OS/2 Pre¬ 
sentation Manager has been around since OS/2 LI 
with very little enhancement. The first new feature 
added was the horizontal scroll bar in OS/2 1.2. 
The only new feature added to it after that 
occurred in OS/2 2.0, in which the extended-selec¬ 
tion capabilities were allowed to be specified as 
the style LS.EHTENDEOSEL. This list box is old in terms 
of control design; it provides no control data, has 
data limitations, and is just quirky. 

Like most of you, we have encountered the list- 
box limitations many times. Our patience ran out, 
and we were tired of writing code to get around 
some of the limitations, so we wrote a replacement 
for the list box. But not just any list box. We need¬ 
ed a list box that could handle more than 2,000 
items or 64K data (whichever the control decided 
to penalize you with), is fast, and can put the cat 
out when needed. 


WHEN TO SUBCLASS 

One way of updating the list box is by subclassing. 
We considered this option very briefly. With sub¬ 


classing, you can achieve some of the design goals 
we will cover here, but you would most definitely 
be hindered by the memory constraints, painting, 
searching, and sorting. We needed total control 
over the list box if we were to get the desired per¬ 
formance* The major drawback is that we have to 
do all the work; we can't assign anything to an 
existing control. 

LIST-BOX DESIGN 

Visually, the list box is not overly complicated, but 
our added enhancements will make it program¬ 
matically complex. As we add new capabilities, 
the design will evolve. We will show you how to 
design controls that take into consideration exist¬ 
ing versions yet allow for increased functionality. 

The existing list box from OS/2 Presentation 
Manager consists of three, distinct visual compo¬ 
nents* The main component, the list area repre¬ 
sented by the ID of the control, creates and main¬ 
tains two additional components: the vertical and 
horizontal scroll bars, having the IDs of OxcOOi and 
0*c0Q2, respectively. Figure 1 shows the IDs of the 
two scroll bars* 

Our first goal is to maintain full compatibility 
with the existing OS/2 Presentation Manager list 
box. Therefore, our first version of the list box will 
handle all the styles listed in Table 1 and the mes¬ 
sages in Table 2* In addition, we will duplicate the 
existing mouse and keyboard handling. 

How does this translate into a control design? 
Basically, we will divide our control into the four 
areas shown in Figure 2, The heap manager, an 
important area, is required since we can't use the 
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control ID 


Q Controls. C 
&CopyThread.C 
Ci Dialogs. C 
G> ExceptionHandler. 
(3 InitC 
0 Install.C 
Q Install.Des 
Q Install. Exe 
QlnstaM.H 





OxcOOt 


0xc002 


Figure t Existing list box design 


heap management designed for use by controls of 
OS/2 Presentation Manager. The heap manage¬ 
ment of PM places a limit of 64K available for use 
by each window or control. This heap manage¬ 
ment is what causes everyone to run into a brick 
wall Later, we will explain in detail why we have 
to implement our own memory-management 
scheme and forego the memory-management ser¬ 
vices provided by the compiler. 

The second area, the list manager, provides the 
means for manipulating the information contained 
within the list box. It will manage the insertion, 
appending, or removal of list items. 

The event manager is used to handle the mouse 
and keyboard-control notification. It ensures that 
items are correctly highlighted, displayed, and 
based on the user's selections. 

The final area, the traffic manager, is used, 
essentially, to direct traffic. Depending on the mes¬ 
sage from the user, the traffic manager will give us 
the means of providing information on the list box. 


ENHANCING THE LIST-BOX DESIGN 

Some of our enhancements to the list box (which 
will be discussed in later articles) are column sup¬ 
port, block list setting, delayed sorting, graphic 
support, direct editing, drag and drop, dynamic 
data exchange, variable CTLDATJl, and enhanced dis¬ 
play. Additional enhancements will be added as 
they become significant 

Consequently, we have to plan for some of 
these issues when we create our first version of the 


Style 

Value 

Meaning 

LS.EKTENDEDSEL 

OxOOOOOOlQL 

Allows extended selection interface of 
more than one item at a time within the 
list box. 

LS.HORZSCROLL 

OxOOOOOOOSL 

Provides horizontal scroll bar at the 
bottom of the list box. 

LS.HILTIPLESEL 

0x00000001L 

Allows selection of more than one item at 
a time within the list box. 

LS.NDADJUSTPDS 

0x000000041 

Causes the list box to be drawn using 
the size provided. 

LS.OWNERDRAW 

0x000000021 

Owner of the list box draws each item 
within the list box if desired. 


Table 1. Existing fist box styles 


Style 

Value 

Meaning 

LHJELETEALL 

0x016e 

Deletes all items in list-box control. 

LM_OELETETTEM 

0x0163 

Deletes a specified item from the list. 

U.INSERTXTEH 

0x0161 

Inserts item text in a list-box. 

lm.quehyitehcount 

0x0160 

Retrieves number of items in a list-box. 

LM_QUER¥ITEMHANDLE 

0x016a 

Retrieves list-box item's handle. 

LH_1)UER YITEMTE X T 

0x0168 

Copies text from item in list-box, 

LMJ U ERYUEMT EXTLEN GTH 

0x0167 

Retrieves item's text length in list-box. 

LMUERYSELECTION 

0x0165 

Retrieves index of selected item in list-box. 

IMJUERYTOPINDEX 

0x016d 

Retrieves index of top item In list-box. 

LH_S E A RCHSTRIH G 

0x016b 

Searches list-box for a match. 

LH.SELEOnEH 

0x0164 

Sets an item's selection state in list-box. 

LMJEirrEHHANDLE 

0x0169 

Sets an item's handle in list-box. 

LM.SETITEHHEIGHT 

0x016c 

Sets height of items in a list-box. 

LM_SETXTEMTEXT 

0x0166 

Sets item text in a list-box. 

LM_SETTOPINDEX 

0x0162 

Sets item to top of list box. 


Table 2. Existing fist box messages 
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list box. The most significant feature is 
the column support. This affects the 
manner in which we store the data sub¬ 
mitted to the list box. 

Under the current design, we only 


of manipulating the information. For 
example, if we use a set of link lists for 
the rows and columns, inserting and 
deleting can become quite interesting. 
If we use the array method, we either 


So What's Wrong with the C 
Run-time Memory Management? 

Nothing, really—if you are writing most applications. But if you are writing a 
control where you need to allocate and release memory quite often, the C run¬ 
time memory management is most definitely not the thing to use. One of the 
reasons is that it is unforgiving. We all make mistakes, since we are not per¬ 
fect (except for maybe Dr. K), but the C run-time libraries expect us to be. If 
you forget to release a chunk of memory you have requested, the run-time 
memory-managers routines won't do it for you since they have to assume (and 
rightly so) that the memory is still being used. Also, you are at the mercy of 
the library writer as to how efficient the routines are with the memory. You 
may be quite surprised how much memory is allocated for that chunk of mem¬ 
ory you requested. Almost all of the C run-time uses the same premise of a 
static block which starts the memory chain of a larger block of memory that is 
then sub-divided through the malloc and calloc functions. Larger requests 
for memory (32K or 64K and larger) are sometimes allocated from the system 
directly, such that the larger block is not part of a linked list. You are expected 
to free this properly, or otherwise, in the case of a DLL, it may just decide to 
stick around. Remember, memory is allocated on a per process basis, there* 
fore a piece of memory allocated in a dynamically loaded DLL will stick around 
even after the DLL has been removed from memory. 


have the capability to look at the infor¬ 
mation as a one-column-by-many-row 
design. Therefore, we can delete by 
individual row or by the entire list box 
(the one column). 

With a multicolumn design, we 
should be able to delete in one of three 
ways—the two methods of the original 
design and the third, by column. 

This feature affects how we store the 
items within a list box. For the new list- 
box design, we can store the items of 
the list box as an array of items or as a 
linked list. Both have their advantages 
and disadvantages. 

For the multicolumn list box, both 
can be used. However, before any code 
is written, we must consider the means 


shuffle up or down the array elements 
when inserting or deleting. Row x is 
the same in all columns and each col¬ 
umn can be an array in its owti right. 

This makes some of the design, in 
terms of the user interaction, interesting. 
The array approach means that the dele¬ 
tion of a column or row is quite difficult 
depending on what is being deleted (the 
column can he the fastest depending on 
memory management). The linked-list 
method means updating the pointers 
both horizontally and vertically. One 
mistake produces a big mess. In this 
case, we will use the array approach. 

Table 3 shows some of the new 
styles planned, and Table 4 contains 
some of the new messages. Not all of 


these will be implemented at the same 
time. In fact, some of the features found 
in the messages will be implemented in 
this first version of the list box. 

One feature is data sorting within 
the list box. A trick we have picked up 
is the hiding of the list box using the 
WinEnableWindowUpdate call, thus forcing 
the list box to hide itself effectively 
while we insert items within it. Once 
we have placed the items within it, 
either sorted or unsorted, we issue a 
WinShGMWindow call to force the painting 
of the list box. 

What is really happening here? Just 
a conjuring trick, actually. First, we 
must understand what happens when 
we don't use the Win Enable WindowUpdate 
call. When we send the message 
LH_INSERTTTEM to the list box, the list-box 
code adds the item in mp2 to its internal 
list. Using the value in mpl, it either 
leaves the item at the end of the list 
(LITJND), sorts the list in ascending 
order (LIT_S0RT- ASCENDING) or descend¬ 
ing order (LIT_SDRTDE SC ENDING), or places 
it in the position specified in mpl. 

As soon as the item has been 
processed, the scroll bar for the list box 
is updated (which may force a repaint¬ 
ing of it) and, depending on the mpl 
value, may cause the contents of the list 
box itself to be repainted. How badly 
the forced repainting is depends on the 
sorting characteristics and the data 
being sorted . 

Interestingly enough, the current 
OS/2 Presentation Manager list box 
doesn't have the intelligence to speed¬ 
up the fill operation, since it doesn't 
pay attention to its visibility state. Since 
we are not going to use linked lists for 
our list box, we will check to see if the 
list box is visible when a new item is 
inserted. We will set a flag within the 
internal data so that when the list box is 
shown, we will sort the information 
within it before the list box is painted. 
Likewise, if the sorting characteristic is 
changed, for example from LIT_ SORT AS¬ 
CENDING to LIT_END, we would perform 
the sort at that time as well. 

This delayed sorting will correspond 
to the LNK.SORT message, which we will 
add to the list box in a later article. 
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Depending on the number of items, this 
could speed up things considerably. 

HEAP MANAGER 

We will implement our own memory 
manager to control the memory usage 
within the list box. Presently, the OS/2 
Presentation Manager list box borrows 
memory from its owner window 
through the owner-window heap. 

Under OS/2 Lx, a message, VW_C0N- 
TftOLHEAP, was used to allow the user to 
specify a different heap. This message 
allows each control a maximum of 64K 
if the owner of the control wants to 
provide it* Under OS/2 2*x, this mes¬ 
sage was removed. 

Therefore, all controls must use the 
same 64K heap for memory, meaning 
that the list box we were using may or 
may not handle the same number of 
the items depending on the memory 
load of the owner window. 

We can't use the C run-time library 
memory managers, since they do not 
allow us to control the manner in which 
memory is allocated. They also cannot 
guarantee minimal, memory configura¬ 
tions when we absolutely require it. 

What we are going to do here is use 
a heap-based system that does not 
require a fixed starting block* In place 
of the fixed starting block, we will use a 
dynamic starting block, which we will 
use as a handle to each different heap. 
Therefore, we can design our control so 
that it uses different heaps for different 
things. And, due to this design, we can 
quickly discard a heap, ensuring that 
the memory is properly released back 
to the system. The goal is to make the 
memory management as fast as possi¬ 
ble and guarantee that we can maintain 
minimal memory impact. 

To make the transition from the tra¬ 
ditional, memory-management calls of 
mallocf), callocO, reallocO, and free() 
shown in Table 5, the memory manage¬ 
ment has duplicated the syntax of the 
calls mostly with the addition of a para¬ 
meter* The first parameter in the call 
must be the heap handle. 

Two additional calls must be used 
to initialize the heap and finally release 
the memory owned by the heap back 


Style 

Value 

Meaning 

LSXJUTGDISPLAY 

0x000001OOL 

Allows the list box to remove or show 
the scroll bars depending on the con 
tents of the list box. 

LSX.LEFTIERTSCROLL 

Ox00000200L 

Provides vertical scroll bar on the left 
size of the list box. 

LSUOPHORZSCROLL 

Ox0O0OO4OOL 

Provides horizontal scroll bar on the 
top of the list box. 

LSXJORIGHTVERTSCROLL 

OxOOOOOSOOL 

Removes the right vertical scrollbar. 

LSX.COLUMNS 

0x000010O0L 

Permits columns to be used within the 
list box. 

LSX.EDITIBLE 

OxOOOO2OO0L 

Permits editing of items within the list box. 

LSKJOCUTPitSTE 

OxOO0O4OO0L 

Disables cutting and pasting within 
list box* 


Table 3. Enhanced fist box styles 



Style 

Value 

Meaning 

LM3LCQPY 

0x0170 

Copy item to clipboard. 

LMJLCUT 

0x0171 

Cut item to clipboard. 

LMX_PASTE 

0x0172 

Paste item from clipboard. 

LHX.QUERVXTHHCOUNT 

0x0173 

Query list box count. 

LMXJJUERYITEHRECT 

0x0174 

Query item display rectangle. 

LMX.qUERYSELECTLIST 

0x0175 

Query multiple selection list. 

LHXJESETLIST 

0x0176 

Reset multiple selection list* 

LHJLSELECTALL 

0x0177 

Sets all item's selection state in list- 
box to on. 

LMX fc SE LECTXTEMRITMA P 

0x0178 

Select item bitmap. 

LMX_$ETARRAY 

0x0179 

Sets list box list using an array of PSZ. 

LMX_SETARRAYHANDLES 

0x017a 

Sets list box list of handles using an 
array of ULGNG, Used mostly for 

OVERDRAW. 

LMX_SETXTEMBITMAPS 

0x017b 

Set item bitmaps* 

LH^SETXTEKOUNT 

0x017c 

Set list box count. 

LMX,SORT 

0x017d 

Sort list box. 


Table 4. Enhanced list box messages, 
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HHEAPMEM 

HeapAHoc(UL0NG cblnitial, UL0NG cbNewBlks); 

PVOID 

HeapCalloc(HHEAPMEM hHeap, UL0NG cltems, UL0NG cbSize); 

PVOID 

HeapMalloc(HHEAPMEM hHeap, UL0NG cbSize); 

PVOID 

HeapReaIloc(HHEAPMEM hHeap, PVOID pv, UL0NG cbSize); 

UL0NG 

HeapSize(HHEAPMEM hHeap); 

VOID 

HeapDisplayStatus(HHEAPMEM hHeap); 

VOID 

HeapFree(HHEAPMEM hHeap, PVOID pv); 

VOID 

HeapRelease(HHEAPMEM hHeap); 

VOID 

HeapStatus(HHEAPMEM hHeap, PULONG pcBlocks, PULONG 
pulSize,PUL0NG pulUsed, PULONG pulFree, PULONG pulUnused, 
PULONG pulOverhead); 


Table 5. Heap manager functions 



to the system. The HeapIQloc call starts 
the heap off by requesting a block of 
memory using the DosAllocMein system 
call. The address returned by DosAl- 
locMem is the starting block for the heap, 
and this value is used as the heap han¬ 
dle. This value, when passed to the 
HeapMalloc, HeapCalloc, HeapRealloc, and 
HeapFree routines, allows each to select 
the starting block correctly and deter¬ 
mine from which memory chain to 
carve or free the memory. 

When the heap is to be discarded 
after it is no longer needed, the HeapRe- 
lease call is used. Depending on the cir¬ 
cumstances, this may be the only call 
required, since all of the memory of the 
heap is released back to the system. 
There is no need to release individual 
memory blocks for the heap, since the 
memory blocks that have been carved 
up from the heap will be discarded. 
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agree on 
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USTMANAGER 

The list manager of the control pro¬ 
vides the main interface to the user of 
the control. The messages of Tables 2 
and 4 go through either the list-man* 
agement area or the traffic-manage¬ 
ment area, depending on the action 
requested. 

List management deals with insert, 
delete, and query of list-box items. It 
should be designed so that it allows con¬ 
trol data to be incorporated. 

This control data will take the form 
of information from some of the mes¬ 
sages in Tables 2 and 4 (for example, 
Utt,SETITEHCQUVT) and for the setting of the 
data within the list. 


EVENT MANAGER 

The event management provides the 
reverse of the list and traffic managers; the 
control sends information back to the 
owner, when significant events occur. This 
is generally denoted by WH_CDMTROL mes¬ 
sages, which indicate a scrolling action, 
item selection, deselection, and so on. 

TRAFFIC CONTROLLER 

The traffic controller handles odd-ball 
requests from the user, which don't 
directly manipulate the contents of the 
list box. Messages, such as UJJUERY- 
TOPINOEK and LH.SETTQPINDEX, are found 
within the traffic-management area. It 
may communicate with the list-box- 


management code but, in general, does 
not affect the contents of the lists. In 
other words, it is passive in nature. 

BEYOND THE BASICS 

Next time, we will explain more of the 
new list box design and begin the task 
of adding some of the new features. As 
we progress on this journey, we will 
keep adding more features until we 
have a list box that really illustrates the 
power underneath the PM hood. 

Mark A. Benge, IBM Programming System 
Laboratory, Cary f N.C., is a staff programmer 
who joined IBM in 1989 and has worked on 
various OJA '91 controls for OS/2 2,x and CUA 
Controls Library/2, He works in IBM user 
interface class library development where he 
was involved in the implementation of C++ 
classes for direct manipulation for the C Set++ 
2.1 product Benge has a fiS, in computer sci¬ 
ence from Western Carolina University : 

Matt Smith, Prominare lnc. f Toronto, Ont, 
Canada, is lead architect for the Prominare 
Development System, an OS/2 2.x 
advanced GUI development environment 
He has been actively involved with OS/2 
since 1988 and co-founded Prominare in 
1990 . Smith has a degree in architecture 
from the University of Waterloo. 
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You can easily write additional functions to extend the function base available to the REXXprogrammer. 
This article provides an explanation and source code for a simple set of external functions written in C. 

By ANDREI MALACINSKI and PATRICK MUELLER 


Extending REXX with 
External Functions 


he REXX language, provided as part of 
OS/2 2.0 and 2d, is an easy-to-Iearn and 
powerful interpreted language. Besides 
offering a number of built-in functions, it allows 
users to add functions to the language by writing 
external functions in C These external functions 
can be written to enhance the function set pro¬ 
vided or to become small layers of code on top of 
a set of existing C functions, making a C func¬ 
tion package available in REXX. 

This article provides the source for a simple set 
of external functions written in C. The article notes 
differences between the C programming environ¬ 
ment and the REXX programming environment 
and provides hints and pitfalls to avoid when 
writing external functions. 

EXTERNAL FUNCTIONS 

REXX contains a number of useful built-in func¬ 
tions, REXXUTILDLi, an external function pack¬ 
age provided with OS/2, contains additional OS/2- 
related functions. Here, we describe how you can 
create external functions packaged in dynamic link 
libraries (DLLs), such as REXXUTIL.DLL. 

The external functions that make up the DLL 
are written in C with a special interface that makes 
them callable from REXX. Each REXX function 
you provide needs a C function that implements 
the REXX function. More than one REXX function 
can use the same C function. 

In C, a function prototype can have many for¬ 
mats: multiple parameters, call by reference, and call 
by value. C functions that implement REXX external 
functions must have the same prototype. 


The prototype must correspond to the following: 

ULONG APIENTRY Functioning 
PUCHAR pszName, 

ULONG ulArgc, 

PRKSTRING prxArgv, 

PSZ pszQueueName, 

PRKSTRING prxRet 

) 

The arguments are: 

* pszNane. This is the name of the REXX function 
invoked. When more than one REXX function 
is implemented by the same C function, this 
parameter is used to determine which REXX 
function was actually invoked. 

* ulArgc, This is the number of parameters passed 

to the REXX function. It is similar to the argc 
parameter to the C main{) function. 

* prxlrgv. This is an array of string parameters. It is 

similar to the argv parameter to the C mini) 
function. However, instead of an array of char *, 
prxUrgv is an array of RXSTRING structures. Each 
RXSTRING contains a parameter and its length. 

* pszQueueName. This is the name of the currently 
defined REXX external data queue. 

* prxRet. This is a pointer to an RXSTRING structure that 

the C function fills to return a value from the 
function to the REXX program. 

THE RXSTRING STRUCTURE 

In the REXX language, the only data type is the 
string. Parameters passed to external functions are 
strings, and the value returned from an external 
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function is a string. REXX strings are 
represented in C with the RKSTRING 
structure. It is defined as: 


typedef struct 

{ 

ULONG strlength; 
PCH strptr; 

} RXSTRING; 


In C, strings always have a hex 00 
character that indicate the end of the 
string. In REXX, all characters are valid 
in a string—even the hex 00 character. 
Therefore, the length of the string 
needs to be encoded outside of the 
string data. In the RXSTRING structure, the 
strlength field contains the length. The 
strptr field is a pointer to the string, 
like a char * variable in C. 

When REXX passes arguments to 
external functions, it adds an extra hex 
00 to the end of each argument. This 
makes it easy to use the strptr fields of 
the RXSTRING in C functions such as str- 
tod() and strtok(). This feature was 
added in OS/2 2-0- 

The REXX language allows empty 
(zero length) strings- The C equivalent 
is a char * variable that points to a hex 
00 character. When a zero-length 
string is passed as an argument to a 
REXX external function, the strlength 
field is set to zero, but the strptr field 
is set to a nonzero value- It is also pos¬ 
sible to omit parameters from a func¬ 
tion call, as in: 

FunctionNameOa",, u b",, "b") 

In this example, the second and fourth 
parameters are omitted. These parame¬ 
ters are passed to REXX, with both the 
strptr and strlength fields set to zero. 

The C language include file from the 
IBM Developers Toolkit for OS/2 2.0, 
REXXSAA.H, contains a number of use¬ 
ful macros for implementing external 
functions. One such macro is RXVALI0- 
STRINGO- In the sample code contained in 
Figure 1, this macro is used when check¬ 
ing parameters. This particular macro 
returns i if the strptr and strlength fields 
of an RXSTRING structure are both nonzero; 
otherwise 0 is returned. 



Figure l External function sample (continued on page 75} 


74 


OS/2 DEVELOPER 

































* change the priority a few times, and print info each time 
-_____-_______--—----*/ 


can Test "-1% 

"NOCHANGE' 1 

, "PROCESS" 

can Test "-1", 

"REGULAR" 

, "THREAD" 

can Test "-1", 

"nKECRmCAL' 1 

rni 

» 

can Test M", 

"FQREGRQUNOSERVER' 1 

. "GARBAGE" 

call Test "0" 



call Test "0", 

"NOCHANGE" 



call Test "l", "NOCHANGE" 
call Test "2\ "NOCHANGE 11 
call Test "3", "NOCHANGE" 

call Test "0", "REGULAR" 

exit 


/*---— - 

* run one test 
--- 

Test: procedure expose pid 
delta = arg(l) 
class - arg(2) 
scope = arg(3) 


*/ 


/*--—-------- 

* call with different # of parameters to test defaulting 

* ------- - */ 

if (arg() = 1) then rc s SysSetPriority(delta) 

else if (arg() = 2) then rc = SysSetPriority(delta,class) 

else if (arg() = 3) then rc ~ SysSetPriority(delta,class,scope) 

if (rc <> 0) then 

say "rc =" rc "from SysSetPriority("delta"/'class","scope")" 


/* -----—-—----- 

* get the priority 

* - — -- — --- — */ 

priority - SysGetPriorityO 


say "priority =" priority, 

"from SysSetPriority{"delta"/'class"/'scope")" 

return 


rxprior.c 


* rxprior.c ; external rexx function to set priority 


Figure 1 . External function sample (continued on page 76) 


PROCESSING THE 
EXTERNAL FUNCTION 

The processing that an external func¬ 
tion needs to perform can be broken 
into three steps: 

1. Process the parameters passed to the 
function. 

2. Perform whatever processing is 
required, based on the parameters. 

3* Set the return value. 

Processing parameters . Because 
REXX cannot prototype functions, the 
user can call external functions with 
any number of parameters. IPs up to 
you to determine whether the parame¬ 
ters that are passed in are correct. 

In the Figure 1, the C function that 
implements SysSetPriorityQ function uses 
the number of parameters that are passed 
in and the values from the RXSTRING para¬ 
meters to perform basic checks and pro¬ 
vide default values. The first check, 



if ({ulArgc < 1) ]] (ulArgc > 3)) 
return 40; 


causes the function to return 40 if no 
parameters or more than three parame¬ 
ters are passed to the function. If 40 is 
returned from an external function, it 
causes the REXX error. Incorrect can to 
routine, to be generated. This error is 
fatal to REXX programs; generate it 
only if absolutely required. The rest of 
the parameter-checking code in the Sys- 
SetPriorityO function provides default 
values for missing or incorrect parame¬ 
ters that are passed in. 

Recall that all parameters are passed 
in as strings. Therefore, the external 
function must convert the received argu¬ 
ments from string format to the appro¬ 
priate data type. In the Figure 1, after 
checking the parameters, the SysSetPrior- 
ityO function converts the strings passed 
in (or defaults) to the types of values it 
needs. It then calls the C function, Dos- 
SetPriorityO, to do the real work. 

Performing function processing . 
Once the parameters have been 
processed and converted into C val¬ 
ues, you need to do whatever pro¬ 
cessing the external function is sup¬ 
posed to do. Generally/ you can do 
whatever you want to do, within the 
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capabilities of C. There are a few 
things to look out fon 
■ Be aware of what the requirements are 
for the functions that you are calling. 
For instance, if you intend to make 
calls to Presentation Manager func¬ 
tions, the current process will proba¬ 
bly need to run in a PM session. 

* Be careful of non-reentrant process¬ 
ing, Although there are few pro¬ 
grams today that allow REXX 
macros to run in multiple threads 
within one process, this capability 
does exist. The same concerns for 
multithreaded programming in C 
are valid for external functions for 
REXX written in C 
Setting return value * To return a 
REXX value from the function, you 
must set fields in the prxRet structure, 
which is passed to the function. If the 
value returned is numeric, you must 
convert the number from the format 
C uses to a string, using sprintf (), for 
instance. The strptr of this particular 
RXSTRING structure points to a 256- 
character-long buffer. If the string 
returned from the function fits in the 
buffer, write the string to the buffer 
and set the strlength field to the 
length of the string. If the string is 
longer than 256 characters, allocate a 
buffer for it, using DosAlIocMemO, 

Note that you cannot use mallocO to 
allocate the buffer. Set the strptr field 
to the address returned by DosAllocHemO. 
REXX will call OosFreeMemO to free this 
memory after it has made a copy of it. 

The external function written in C 
must return an unsigned long value. 
Remember that returning 40 from an 
external function causes a REXX error 
to occur in the program running the 
function; any nonzero return code 
from an external function will cause 
a fatal REXX error to occur. Make 
sure you return 0 from your external 
function, unless you specifically want 
to cause a fatal error. 


REGISTERING THE EXTERNAL 
FUNCTIONS IN THE DLL 

Before calling the external functions in 
the DLL from a REXX program, the 
REXX program must register them. 


*—---—--*/ 

tindude <stdio.h> 
tindude <stdllb,h> 
tindude <string.h> 

tdefine INCL.SASE 
tindude <os2.h> 

tdefine INCL.REOSM 
tindude <rexxsaa.h> 

/*------—--- 

* prototypes for rexx functions, to make sure we declared everything 

* correctly 

*”-----*/ 

RexxFunctionNandler SysSetPriority; 

Re x x F u n ctio n H a ndler $ y sGetP rio rit y ; 

tpragma linkage(Sys$etPriority, system) 
tpragma linkage(SysGetPriority, system) 

/*--------- 

* this function is called when user invokes SysGetPriorityO in REXX 

* 

* expects no parameters 

*—-------#/ 

ULQNG JIPIENTRY SysGetPriority( 

POAR pszName, 

U10NG ulArgc, 

PRKSTRING prxArgv, 

PSZ pszQueueName, 

PRXSTRING prxRet 

) 

PPIB ppib; 

PTIB ptib; 

APIRET rc; 


/*- 

* call DosGetlnfoBlocksO 

* ------ --*/ 

rc = DosGetlnfoBlockst&ptib^ppib); 

/*-----—----- 

* put priority in return code 

*---- — ------ — */ 


sprintf(prxRet->strptr, M )!08.Six",ptib*>tib^ptib2->tib2_ulpri); 
prxRet->strlength = strlen(prxRet->strptr); 

return 0; 


Figure 1. External function sample (continued on page 77) 
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* this function is called when user invokes SysSetPriorityO in REXX 

* 

* expects the following parameters 

* 1 - number between -31 and 31, the delta of the priority to set 

* 2 - optional class: "NOCHANGE", "IDLETIME", "REGULAR", 

* "TIMECRITICAL", "FOREGROUNDSERVER" 

* 3 - option scope: "PROCESS", "PROCESSTREE", "THREAD" 

* 

*-*/ 

ULONG APIENTRY SysSetPriority( 


PUCHAR 

pszName, 

ULONG 

ulArgc, 

PRXSTRING 

prxArgv, 

PSZ 

PRXSTRING 

) 

{ 

pszQueueName, 

prxRet 

APIRET 

rc; 

PSZ 

pszDelta; 

PSZ 

pszQass; 

PSZ 

pszScope; 

ULONG 

ulScope; 

ULONG 

ulQass; 

LONG 

IDelta; 


/*- 

* make sure there are 1, 2 or 3 parameters 

♦ -*/ 

if ((ulArgc < 1) ]] (ulArgc > 3)) 

return 40; 

A- 

* apply default parameters 

* -*/ 

if (RXVALIDSTRING(prxArgv'0 )) 

pszDelta = prxArgv'O .strptr; 
else 

pszDelta = "0"; 

if ((ulArgc >= 2) && RXVALIDSTRING(prxArgv"1 )) 
pszCLass = prxArgv'l .strptr; 
else 

pszQass = "NOCHANGE"; 

if ((ulArgc >= 3) ftft RXVALIDSTRING(prxArgv'2 )) 
pszScope = prxArgv'2 .strptr; 
else 

pszScope = "PROCESS"; 


Figure 1 . External function sample (continued on page 78) 


To do this, use the RxFuncAddO function. 
The RxPrior.cmd file provides an example 
of registering the two external functions 
given in RxPrior.dQl 

Registering a function associates 
the function name used in REXX pro¬ 
grams with a DLL and an entry point 
in the DLL (the name of the C func¬ 
tion). You can use the same entry 
point for more than one REXX func¬ 
tion. This is useful if several external 
functions perform similar processing. 
By examining its first parameter, the 
external function can determine which 
function was actually invoked. 

Once an external function is regis¬ 
tered, it is available to any REXX pro¬ 
gram in the system. Thus, the person 
using the external functions only needs 
to register them once, for example, in 
STARTUP.CHD. A REXX program can check 
if an external function has already been 
registered with the RxFuncQueryO function. 

External functions can also be regis¬ 
tered in C. This can be useful with a 
DLL that has a large number of func¬ 
tions. Instead of requiring the user of 
the external-function package to call 
RxFuncAddO for each function, you can 
provide one external function that 
loads all the other functions. External 
functions can be registered from C with 
the function RexxRegisterFunctionDIlO. 

The REXXUTIL.DLL provided with 
OS/2 uses this technique to register 
its functions. First, you register the 
function SysLoadFuncs in REXX with 
the RxFuncAddO function, then you call 
it. This function calls RexxRegisterFunc- 
tionDIlO on the rest of the functions. 
REXXUTIL.DLL also provides a function, 
SysDropFuncs, to unregister the func¬ 
tions. Unregistering a function is a 
system-wide operation, much like 
registration. After unregistering a 
function, the function will be 
unavailable to REXX programs run¬ 
ning on the system, until it is regis¬ 
tered again. 

COMPILING AND LINKING THE 
EXTERNAL FUNCTIONS 

When writing external REXX functions 
in C, include the following lines for 
each external function you write: 
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RexxFuncdonHandLer FunctionName; 

Ipragma linkage(FunctionNanie, system) 

The first statement prototypes the func¬ 
tion* If you use the incorrect argument 
types or forget an argument, this proto¬ 
type will cause a compiler error to be 
generated. An external function that 
does not have the correct prototype can 
cause the external function to behave 
incorrectly or cause an access violation. 

The ipragma statement ensures that 
the function has the system linkage 
(as opposed to the optlink linkage) for 
C Set/2* 

A make file is provided with the sam¬ 
ple in Figure L The options used will 
compile and link the source with C Set/2 
compiler and thelink386 program. 

A .def file is also included. Each of the 
external functions in C needs to be 
exported from the DLL. 

The DLL must be linked with 
REXX. LIB, in addition to the standard C 
libraries and any additional libraries that 
are needed. 


DEBUGGING THE 
EXTERNAL FUNCTIONS 

External functions contained in a DLL 
can be debugged with the IPMD 
debugger. Invoke IPMD with the 
command: 


IPMD cmd /c myprog 

where myprog.cmd is a REXX .CMD fiie 
containing calls to the external functions. 
Once IPMD starts, set a load breakpoint 
on your DLL and have IPMD start the 
process. Your DLL will load when the 
first function is called in it. At this point, 
set breakpoints, single step, and so on, 
within the debugger. 

If you need to recompile your DLL 
after using it, the link step may fail with 
an error indicating that the run file (the 
DLL) cannot be opened. This is because 
when a REXX program is run from a 
CMD.EXE command prompt, it is run in 
the current OS/2 process. Specifically, 
your current CMD.EXE session has the 
DLL loaded. In fact, all of the currently- 
open CMD.EXE sessions might have the 
DLL loaded. OS/2 does not allow DLLs 


/*--- —— -------- 

* convert delta to a number 

* ---—----—-—*/ 

IDelta = strtol(pszDelta,N'lJLL,10); 

/*------ 

* convert class to a pre-defined constant 

* -- - -—*/ 

If (fstricmpCpszQass, "NQCHANGE 11 )) 

uldass = PRTYCJKMNGE; 

else if {istricmp(pszCLass f "IDLETIME")) 
uldass = PRTYCJCDLETIHE; 

else if (!stricmp(pszCLass, "REGULAR")) 
uldass * PRTYC_REGULAR; 

else if (SstricmpCpszCLass, "TXMECRrTICAL")) 
uldass = PRTYCJTMECRI11CAL; 

else if (IstricmpCpszQass, "FQREGRQUNDSERVER")) 
uldass = PRTYCJQREGROUNDSERVER; 

else 

uldass = PRTYCJQCHANGE; 

/* -- - ---- 

* convert scope to a pre-defined constant 

* ------—--—-*/ 

if (!stricmp{pszScope, "PROCESS")) 

ulScope = PRTYS_PROCESS; 

else if (!stricmp(pszScope, "PROCESSTREE")) 
ulScope = PRTYS.PRDCESSTREE; 

else if OstricmpCpszScope, "THREAD")) 
ulScope = PRTYSJHREAD; 

else 

ulScope = PRTYS.PROCESS; 

/* ---- 

* call the DosSetPriorityO function 

*---—-*/ 

rc = DosSetPrioritytulScopejUlClasSjlDelta^); 

h ---——-- 

* set return value 

* -—--—---+/ 

sprintf(prxRet->strptr,"7Jd",rc); 

prxRet->strlength = strlen(prxRet->strptr); 

return 0; 

} 

Figure L External function sample (continued from page 771 
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that are currently loaded to be erased or 
written to. To remove the DLL, you need 
to unregister each of the functions. Exter¬ 
nal functions can be unregistered with 
the RxFuncDropO function in REXX or the 
RexaDeregisterFunctionO function in C. 
After unregistering the functions, you 
must exit all, currently-open, CMD.EXE 
sessions, OS/2 wiil then drop the DLL 
from the system. At this point, you can 
start new CMD.EXE sessions and erase 
or relink the DLL, 

REXX MACROS IN 
THE CURRENT PROCESS 

REXX macros have a significant differ¬ 
ence from other OS/2 executable files: 
they do not start a new process. A REXX 
,CMD file, run from a CMD.EXE session, 
runs in the same process as the 
CMD.EXE program. OS/2 does not start 
a new process for the program or end it 
when the program terminates. 

This is important, because OS/2 
resources are not cleaned up when a 
REXX macro ends. For example, mem¬ 
ory allocated with mallocQ or DosAl- 
locMemO from an external function is 
not freed when the REXX program 
that used the external function ends. If 
you need to use these functions to 
allocate memory from within an exter¬ 
nal function, free the memory before 
the external function returns or it will 
remain allocated within the CMD.EXE 
process. If you forget to free the mem¬ 
ory, you won't be able to free it later, 
because you will have lost the pointer 
value. The only way to free the memo¬ 
ry will be to exit the current 
CMD.EXE process. 

This also has implications for DosEx- 
itListO processing. If your external 


function uses another DLL that depends 
on DosExitListO processing, this process¬ 
ing won't occur until after the CMD.EXE 
process has terminated. 

You can get around this limitation by 
writing a C program that invokes REXX 
macros with the RexxStartO function. The 
program can register the external func¬ 
tions before starting the REXX macro 
with the RexxRegisterFunctionDIlO or 
RexxRegisterFunctionExeQ functions. The 
first argument to the program should be 
used as a REXX macro name, and the 
remainder should be concatenated to 
form the parameter string to be passed 
to the REXX macro. 

This C program can then be used 
with the EITPROC facility of OS/2. In a 
,CMD file, make the first line: 

EXTPROC myCprog 

where myCprog is the name of the C 
program. 

When OS/2 runs the .CMD file, it rec¬ 
ognizes the EXTPROC statement and starts 
the myCprog program with the parameters 
specified on the command line for the 
.CMD file. The C program is then in con¬ 
trol. A new process starts and will termi¬ 
nate when the program ends. Therefore, 
OS/2 resources, such as memory and file 
handles, will be cleaned up when the 
myCprog program ends. 

You should unregister the REXX 
functions that were registered by the C 
program, before the C program exits. 

EXTERNAL FUNCTION SAMPLE 

The sample code implements two func¬ 
tions: SysGetPriority {) and Sy sSetP riority (). 
These functions are used to query and set 
the priority of the current process. 


SysGetPrxorityO. This function expects 
no parameters. It returns an eight-digit 
hex string that indicates the priority of 
the current process. The function returns 
the priority from a field in the info- 
blocks structure returned by the DosGet- 
InfoBlocksO function. 

SysSetPriority (delta, class, scope). 
This function expects the delta para¬ 
meter to be a number from -31 to 31; 
the class parameter to be one of the 
strings, NOCHANGE, IDLETIME, REGULAR, TIME- 
CRITIC AL, or FOREGROUNOSERVER; and the 
scope parameter to be one of the 
strings, PROCESS, PROCESSTREE, or THREAD. 
The parameters correspond to the val¬ 
ues expected by the DosSetP riority () 
function. The external function calls 
this function and returns the return 
code from that function. The delta 
parameter must be passed in, but the 
other two are optional. Missing or 
incorrect parameters cause default 
values to be used. 

RxPrior.cmd tests the external func¬ 
tions by calling SysSetPriorityO a num¬ 
ber of times with different parameters. 
After each call to SysSetPriorityO, SysGet¬ 
PriorityO is called to determine what the 
priority was set to. The resulting value is 
printed as output from the program. 

CONCLUSION 

The REXX language allows for expan¬ 
sion of its function base through exter¬ 
nal functions. Based on that design, 
and with the help of these tips and 
explanations, you are capable of 
extending the language to meet your 
needs. Go for it! 

Andrei Malacinski, IBM Programming Sys¬ 
tems, Cary N.C., is a member of the Distrib¬ 
uted Application/2 programming team. He 
joined IBM in 1990, after receiving degrees 
in mathematics and computer science from 
Indiana University. 

Patrick Mueller, IBM Programming Sys¬ 
tems, Cary N>C, is a member of the Object 
Oriented Strategy Department. He joined 
IBM in 1985i after receiving degrees in math¬ 
ematics and computer science from Purdue 
University, He can be reached at 
pmuelfr@vnet. ibm . com . 
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WITH OS/2 2.1, Third Edition by Robert 
Orfali and Dan Harkey. OS/2 MONTHLY called 
the 2nd Edition ‘The OS/2 Book of the Year!” 
Others said individual chapters were by 
themselves “worth the price of the book. ” 

This new edition keeps you state-of- 
the-art in OS/2 client/server 
developments. $39.95 0-442-01833-9 

02/2 2.1 CORPORATE 
PROGRAMMER’S 
HANDBOOK 

by Nora Scholin, Martin Sullivan 
and Robin Scragg. A quick and 
easy modular approach to writ¬ 
ing software programs. Gives 
code examples for using OS/2 
2.1 to its full potential. 

$39.95 0-442-01598-4 



OS/2 2.1 REXX HANDBOOK: 
Basics, Applications and Tips 

by Hallett German. A one-stop 
guide to one of the most popular 
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a basic tutorial with fast answers 
to all REXX questions. 
$29.95 0-442-01734-0 

WRITING OS/2 2.1 DEVICE 
DRIVERS IN C, Second Edition 

by Steven J. Mastrianni. Defines each 
type of driver and how to fit them into 
your system with tips on debugging, 
tuning, and enhancing driver 
performance. Includes disk with 
source code for four complete drivers 
plus all source code found in book. 
$39.95 with disk. 0 - 442 - 01729-4 
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Buyers'Guide 



The staff of OS/2 Developer put together this special section to guide you through the various database devel¬ 
opment tools available for OS/2. The products described in this guide are based on surveys sent to vendors; 
they are provided as a service to you and are free to vendors. These listings do not represent an endorsement by 
OS/2 Developer. Although every effort has been made to ensure accuracy, we do not assume any responsibility 
for error or omission in this section. Please contact the companies directly for more information. 


Database Development 
Tools Buyers' Guide 


THE ASK GROUP INC. Circle No. 101 

ASK INGRES 6.4 Intelligent Database is a member of 
the Database and Connectivity Product Unit's 
family of intelligent relational database manage¬ 
ment products and services. It helps companies 
manage not only data, but knowledge (business 
rules) and objects (non-conventional data such 
as maps and pictures) as well. ASK INGRES 
operates on many hardware platforms and 
enables customers to develop and operate infor¬ 
mation systems for the client/server environ¬ 
ment. Call for pricing information. 

The Ask Group Inc., 1080 Marina Village 
Pkwy., Alameda, Calif. 94501, (800) 446-4737 or 
(510) 769-1400, fax (510) 748-2670. 

BACHMAN INFORMATION 

SYSTEMS INC. Circle No. 102 

Bacbman/DLL Generator for DBM and DB2/2 is a part 
of Bachman's family of 17 products for database 
access, design, modeling, and analysis. It pro¬ 
vides a bi-directional interface between the 
OS/2 databases. Extended Edition Database 
Manager and DB2/2, and Bachman/DBA, a 
graphical database design environment. Bach¬ 
man/DDL Generator for DBM and DB2/2 
allows users of Bachman modeling and data¬ 
base design products to implement databases in 
the Database Manager or DB2/2 relational data¬ 
bases. It also allows database administrators to 
re-engineer existing databases from another 
DBMS into DBM or DB2/2, or from DBM or 
DB2/2 into another DBMS. Price: $3,500; quan¬ 
tity discounts apply. 


Bachman Information Systems Inc., 8 New Eng¬ 
land Executive Pk. ( Burlington, Mass. 01803, (617) 
273-9003, fax (617) 229-9904. 

BORLAND INTERNATIONAL Circle No. 103 

Borland C++ for OS/2 1.0 is a development system 
for creating OS/2.x applications. The compiler 
produces a 32-bit object code and supports devel¬ 
opment of multithreaded applications, mixed¬ 
mode programming in OS/2, and the OS/2 calling 
conventions. Features, such as on-line IPF help 
and documentation, PM-hosted environment, inte¬ 
grated GUI debugger and the new resource Work¬ 
shop for OS/2, aid in designing and modifying 
OS/2 resources like bitmaps, icons, dialogues, 
strings, and menus. Price: SRP, $495; Borland C++ 
Customers, $149.95. 

Borland International, 100 Borland W., Scotts 
Valley, Calif. 95066-3249, (800) 331-0877 or (408) 
431-1000, fax (408) 431-9119. 

COMPUTER ASSOCIATES 

INTERNATIONAL INC. Circle No. 104 

CA-Realizer 2.0 lor OS/2, a visual programming envi¬ 
ronment, handles the mechanics of event-driven 
programming, message passing, and process shar¬ 
ing. It also handles GUI programming, including 
memory management, event handling, and multi¬ 
tasking. It combines visual development tools, 
Programmable Application Tools, and a structured 
superset of BASIC extended to access Windows 
and OS/2 objects and resources. Other enhance¬ 
ments include FormDev, which allows developers 
to design visual elements of a program by using 
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standard graphical objects, true record structures, 
nested families, matrix functions, and multidimen¬ 
sional arrays in up to 30 dynamically expandable 
dimensions. CA-Realizer includes built-in tools 
such as charts (pie, candlestick, I-beam, horizontal- 
bar, filled-area, and Grant types), spreadsheets, 
boards, logs, animation, graphics tablets, and a 
scheduler. It supports the Open Database Connec¬ 
tivity standard (ODBC) and imports and exports 
Xbase (.DBF) files, generating data entry forms in 
FormDev. Applications built with CA-Realizer 
may be distributed free of royalty or license fees. 
Price: $99, until March 31,1994; $247, after March 
31,1994. 

Computer Associates International Inc., One 
Computer Associates Plaza, New York, NY 11788- 
7000, (800) 225-5224 or (516) 342-5224, fax (516) 
342-5329. 

CONSYST SQL INC. Circle No. 105 

SQL Design 2.0 is a fourth generation productivity 
tool built as a shell on many SQL databases. It is 
used for development and maintenance of appli¬ 
cations. Its centralized repository concept is the 
same used in computer aided software engineer¬ 
ing tools where all data and application elements 
are stored. This repository is linked to the generat¬ 
ed applications and eliminates data and function 
duplication. Price: $750-5,000. 

Consyst SQL Inc., 15 Mont-Royal Street Ouest, 
Suite 120, Montreal, Quebec, Canada, H2T2R9, 
(514) 849-7431, fax (514) 849-8125. 

COPIA INTERNATIONAL LTD. Circle No. 106 

AccSys for Paradox 4.0 provides C, QuickBasic, 
and/or Visual Basic programmers with access to 
the database routines found in Paradox, as well as 
the ability to create, read, write, modify, and 
update Paradox files without having to learn the 
internal file formats. Paradox's interface provides 
users with tools for control over Paradox primary 
and secondary index files, as well as tables. AccSys 
supports Borland C, C++, Microsoft C, Zortech, 
WATCOM. It allows for standalone program con¬ 
struction. Network-compatible. No runtime royal¬ 
ties. Price: $1195, for product with source. 

AccSys for dBASE2.92 enables C and/or Visual- 
Basic programmers to update xBASE, dBASE III 
and IV file types. It works with MDX and NDX 
index files and DBT memo files and also handles 


the DBF, NDX, and DBT files in both dBASE III 
(PLUS) and IV formats. AccSys supports Borland 
C, C++, Microsoft C, Zortech, WATCOM, FoxPro, 
and Clipper. It allows for standalone program con¬ 
struction. Network-compatible. No runtime royal¬ 
ties. Price: $495. 

Copia International Ltd., 1342 Avalon Ct., 
Wheaton, Ill. 60187, (708) 682-8898, fax (708) 665- 
9841. 

DA TA ACCESS CORPORA TION Circle No. 107 

DataFlex 3.01, an application development environ¬ 
ment, combines an object-oriented fourth generation 
language, a WYSIWYG application generator, a rela¬ 
tional database management system, and a set of 
built-in productivity tools and utilities. DataFlex is 
portable and is available in several languages, 
including Danish, English, French, German, Italian, 
Norwegian, Portuguese, and Swedish. Price: $795 
(single user); $1450 (multiuser). 

Data Access Corporation, 14000 S.W. 119 Ave., 
Miami, Fla. 33186-6017, (800) 451-FLEX or (305) 
238-0012, fax (305) 238-0017. 

DESKTOP Al Circle No. 108 

X2c 1.15 Portable Xbase Compiler for OS/2 is an 

open Xbase compiler used to create OS/2 32-bit 
compiled .EXEs. It creates a C version of the 
application by using a native C compiler; for 32- 
bit applications, X2c uses the Borland C++ com¬ 
piler. X2c supports characteristics of Xbase vari¬ 
ables, including macroed expressions with UDF 
calls and type re-assignment; features of dBASE 
III+, Clipper (S'87), Foxbase+ 2.1; and many fea¬ 
tures of FoxPro, such as user defined functions, 
VALID ( ), C/prompt /menu, 142 dimension arrays, 
and array functions: DBEDIT( ), ACHOICE ( ), NEMOED- 
IT ( ), READ MENU, windows, buttons, BROWSE. All 
support functions are available in C source, and 
C routines can be added. Price: $1,000 (call for 
special prices). 

Desktop Ai, Box 59, Georgetown, Conn. 06829, 
(203) 255-3400, fax (203) 259-8853, e-mail 
sales@dtop.com or CIS: 76137/3727. 

DIGITALK Circle No. 109 

PARTS Relational Database Interface 2.0, a compan¬ 
ion product to PARTS Workbench, allows the user 
to create graphical client/server applications that 
use SQL databases. ANSI standard SQL and SQL 
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extensions are supported for each data¬ 
base. The product supports the follow¬ 
ing databases: Microsoft/Sybase SQL 
Server, Oracle, IBM DB2/2, IBM DB2 
through the MicroDerisionWare gate¬ 
way, IBM DB2, OS/400 and SQL/DS 
through the fBM DDCS/2 gateway, 
IBM Extended Services Database Man¬ 
ager, Gupta SQLBase, dBASE III Plus, 
dBASE rV, Novel) NetWare SQL Data¬ 
bases, XDB Database Management Sys¬ 
tem, Btrieve, Excel files, and text files. 
The PARTS relational database inter- 
face allows the user to create graphical 
front-end applications that work inde¬ 
pendently of the database they access, 
making it possible to create client/serv¬ 
er applications that are portable across 
different databases. Price: $995, 

Digitalk, 5 Hutton Centre Dr., Santa 
Ana, Calif. 92707, (800) 922-8255 or 
(714) 513-3000, fax (714) 513-3100, e- 
mail sales@digitalk.com. 

DSOFT DEVELOPMENT INC Circle No, HO 
dbfLIB IMS Programmers Library is a 

C/C++ programmer's library for 
accessing dBASE data files and indexes. 
It indudes royalty-free, dynamic-link 
libraries for Windows, QS/2 13 (16- 
bit), and OS/2 2,x (32-bit) and supports 
Microsoft, Borland, and IBM Compil¬ 
ers. dbfLIB provides a consistent set of 
APIs across DOS, Windows, and OS/2 
platforms, allowing the user to devel¬ 
op new applications than can share 
dBASE files with dBASE programs cur¬ 
rently in use, as well as other programs 
that use dBASE files. Price: $159. 

dSOFT Development Inc., 4710 Inns- 
bruk Dr., Houston, Tex. 77066, (713) 
537-0318, fax (405) 360-3045, Com¬ 
puServe 70562,1044. 

EASEL CORPORATION Circle No lit 
ENFIN 2.9 is an object-oriented, visual 
development environment used for 
building a variety of client/server appli¬ 
cations. It is based on the Smalltalk pro¬ 
gramming language. ENFIN supports 
reusability and portability. Applications 
built with ENFIN are portable between 
OS/2, Windows, and UNIX. Price: $5,995. 

Easel Corporation, 25 Corporate Dr., 
Burlington, Mass. 01803, (800) OBJECTS 


(625-3287) or (617) 221-2100, fax (617) 
221-6899. 

FAIRCOMUSA/ 

FAIRCOM EUROPE Circle No, 112 

c4ree Plus File Handler $.0 rel.e allows 
users to use low-level routines or take 
advantage of the ISAM routines for 
high speed random or sequential 
access, it has C source code and is port¬ 
ed to 100+ environments. It is designed 
for single-user, multiuser or client-side 
application development, e-tree Plus 
File Handler includes: transaction pro¬ 
cessing, fixed-variable length records 
and keys, file level alternate collating 
sequence, duplicate keys and/or auto¬ 
matic sequence numbers, native oper¬ 
ating system I/O utilization for porta¬ 
bility, dynamic space reclamation, high 
speed hashed data/index caching, mul¬ 
tiple simultaneous sets/batches, and 
resource records super files. It has 
ISAM functionality and is ANSI proto¬ 
typed. Royalty-free. Call for a complete 
list of features. Price: $595. 

Mree Report Generator tie provides 
multiline reports by handling aspects 
of report generation. The user calls the 
r-tree report function, which then 
reads c-tree data files, performs calcu¬ 
lations, monitors control breaks and 
accumulators, and produces a format¬ 
ted report, r-tree comes with C source 
code and supports many C compilers. 
It requires c-tree Plus. Specify plat¬ 
form: DOS (Windows 3.x, OS/2, 
UNIX TAR, QNX 4.X, Coherent, and 
Xenix) or Macintosh. Specify 5.25-inch 
or 3.5-inch disks. Limited 30 day 
guarantee. Price: $295. 

FairCom SQL Server 603.16 is a data¬ 
base server that utilizes the c-tree Plus 
Application Programmer's Interface 
(API) plus an ANSI 1986 level 2 SQL 
engine. It provides data integrity 
through multiuser transaction process¬ 
ing and includes client side source 
code. Specify operating environment: 
DOS, OS/2, AT&T UNIX, SCO UNIX, 
SCO Xenix, Apple A/UX, Interactive 
UNIX, QNX, Banyan VINES, Sun 
SPARC, HP9O00, RS/6000, 88 OPEN. 
Specify 5.25-inch or 3.5-inch disks. Lim¬ 
ited 30 day guarantee. Price: $445-3,795, 


depending upon platform; number of 
users. Call FairCom, 

FairCom Server 6,03.16 is a transaction 
processing server. Its features include: 
industrial quality transaction process¬ 
ing, including full commit and rollback; 
intermediate save points and complete 
logging; automatic log management; 
restart/disaster recovery; user pass¬ 
words; access security and on-line 
administration; deadlock detection/ 
resolution; and read/write locks at the 
record/individual key level. Specify 
operating environment: DOS Extend¬ 
ed/Windows Hosted, OS/2, AT&T 
UNIX, SCO UNIX, Interactive UNIX, 
QNX, SUN SPARCHP 9000, RS/6000, 
880PEN, Banyan VINES, Data General 
Avion, NLM, SCO Xenix, Apple A/UX. 
Specify 5.25-inch or 3.5-inch disks. Lim¬ 
ited 30 day guarantee. Price: $295-2,495, 
depending upon platform, number of 
users. Call FairCom. 

Natural Query enables the user to 
query c-tree Plus databases without pro¬ 
gramming. The user can formulate 
queries using English, ANSI standard 
Structured Query Language or Query-By- 
Example. In addition, sessions main¬ 
tained for reuse of queries/reports. Nat¬ 
ural Query also allows the user to cus¬ 
tomize personal vocabulary. The 
Developer's Package allows the user to 
add NQ's capabilities to developer appli¬ 
cations, giving end users the ability to 
query in English/SQL/QBE. Specify 
DOS or OS/2. Specify 5.25-inch or 3.5- 
inch disks and whether c-tree/c-tree Plus. 
Limited 30 day guarantee. 2.5 lbs. Price: 
$169, end user; $395, developer's package. 

d tree Development Tool 3.2 rei e offers 
beginning programmers a bridge to the 
control, flexibility, and portability of C 
development. Its features include pro¬ 
ductive front end for c-tree; complete 
portable screen handler; menu/HELP 
management; data dictionary; file/field 
level editing/validation; and resource 
swapping; runtime control of program 
resources. Specify 5.25-inch or 3.5-inch 
disks (includes DOS & UNIX TAR). 
Version 3.2 release e. Limited 30 day 
guarantee. Price: $495, 

FairCom USA, 4006 W. Broadway, 
Columbia, MO 65203, (800) 234-8180 or 
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Now you can get Special Reports for Virtual Reality , Neural 
Network, and Al in Finance at incredibly low prices! This 
offer won't last forever, so order now. Don't take a chance! 

Don't miss this incredible offer! 



& YES! 


Please send me the Special Reports that I have marked below: 


# of 
copies 

_ 1992 Virtual Reality Special Report $9.95 

_March 1993 Virtual Reality Special Report $9.95 

_August 1993 Virtual Reality Special Report $9.95 

_ 1992 Neural Network Special Report $7.95 

_ 1993 Neural Network Special Report $7.95 

_Neural Net Primer Special Report $7.95 

(Available in December 1993) 

_AI in Finance Special Report $7.95 
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Address_ 
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State_Zip 

Prepayment is Required. 


Subtotal for_copies of all VRSR @ $9.95 each. 

Subtotal for_copies of all NNSR @ $7.95 each. 

Subtotal for_copies of AIFSR @ $7.95 each. 

TOTAL 

FAX (415) 905-2233 or call (800) 444-4881 

Allow up to 6 weeks for delivery of your first issue. Payable in U.S. dollars. Please make checks payable to Miller Freeman. Canadian GST #124513185 
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(314) 445-6833, fax (314) 445-9698. Fair- 
Corn Europe. Via Softocorna 15/17, 
24021 Albino (BG) Italy, 035/773464, 
fax 035/773806. 


GPFSYSTEMS INC. Circle No . 113 

Gpf 2.0 Single Platform is a WYSIWYG 
CUA 91 application development/ 
source code generator for OS/2 PM 2.x. 
Its client-window support permits the 
user to manipulate controls including 
size, position, font, and color. In addi¬ 
tion, Gpf allows the user to link built-in 
and user function, IFF help panels, and 
help messages at design time without 
leaving the graphics interface. It uses 
SQL code generation for OS/2 Data¬ 
Base to fill list boxes from existing 
tables. Gpf supports multithread 
designs and generates ANSI "C" code 
as well as ancillary files. Price: $495. 

Gpf Systems Inc., 30 Falls Rd., P.O. 
Box 414, Mood us, Conn. 06469, (800) 
831-0017 or (203) 873-3300, fax (203) 
873-3302, 


GSI (GRAPHICAL SOFTWARE 
INTERFACES) INC. Circle No. 114 

SQL Objects ++ 1.1 Database Class Library 

is a collection of optimized C++ data¬ 
base classes that provide direct access 
to SQL and non-SQL databases. It pro¬ 
vides access for each database the user 
works with. The user is not restricted 
to a handful of common C APIs and 
can access DBMS-specific calls with 
powerful C++ classes. It provides an 
object-oriented approach to database 
access. Each powerful class represents a 
specific DBMS that is derived from a 
common base class. The user can derive 
new classes with extensions. SQL 
Objects++ Database Class Library has 
32-bit database access and multiplat- 
form support. It enables the user to 
build one application that accesses 
DB2/2, Oracle, Sybase, SQL Server, 
Netware SQL, Btrieve and others that 
can also run in the OS/2, UNIX, DOS, 
Windows, and NT environments. No 
royalties. The OS/2 version also sup¬ 


ports SOM (system object model). 
Price: $699, 

GSI {Graphical Software Interfaces) 
Inc,, 47 Stonewall St., Cartersville, Ga. 
30120, (800) 876-6585 or (404) 382-6585, 
fax (404) 382-6374. 

GUPTA CORPORATION Circle No. 115 
SQLBase Server 5.1 aids the user in cre¬ 
ating graphical applications, OLTP 
(on-line transaction processing) and 
decision support, its features include 
client/server architecture crash 
recovery, password protection, on¬ 
line backup, remote monitoring and 
diagnostic tool. Multiple users can 
simultaneously perform data entry, 
browse between PC front end appli¬ 
cation and multiple sets of data 
records, and do background report¬ 
ing at anytime while data is being 
updated. Front ends for SQLBase 
Server include: SQLWindows, Quest, 
SQR, Access SQL, C, COBOL, Clip¬ 
per, dBXL/SQL, Forest &Trees, JAM, 


m 

TUB Version Control 

For DOS, OS/2 and Windows-NT 

• The experts loved TL1B 4: 

"...amazingly fast... TUB is a great system ." PC Tech Journal 

"TUB has features and power to spare. . . TUB is easy to use and 
the fastest of the reviewed packages. ** Computer Language 

'7 will not program without it .' Uptime Magazine 

* Now TUB 5.0 adds: 

Automatic branching. Automatic version labeling across branches. 
User defined promote structures, for staged development. Exclusive 
whole-levaI change migration for customized software, N-way-tree 
version numbers. Branch and full locking, OS/2 & NT support. 


# Plus the features they loved in TLIB 4: 

Check-in/out locking. Branching, for parallel development. Keywords, 
Full binary file support (does not depend upon CRs in the file like other 
products). Wildcard and list-of-file support; can create fists by scanning 
source code for includes. Can merge (reconcile) multiple simultaneous 
changes and undo intermediate revisions. Network and WORM optical 
disk support. Mainframe-compatible delta generator for Pansophic, 
ADR, IBM. Sperry formats. Includes integrated PD MAKE by L. Dyer; 
also integrates with Opus™ MAKE, Slick™ MAKE, others. 


MS-DOS $139, OS/2 8, NT (with MS-DOS) $195 + shipping, 

5 station network: MS-DOS $419, OS/2 $595. Call for other sizes. 



Burton Systems Software 


PO Box 4156, Cary, NC 27519 (919) 233-8128 

FAX: 233-0716 



OS/2 

Sava Paper Wttti File Llater/2 

► Reduce the amount of paper you use by 
printing text files te 1.2* or 4 pages per 
sheet of paper. 

► If your primer supports duplex printing, 
gel up 10 8 pages per sheet of paper 

► Take advantage of the installed sysiem 
fonts. 

► Great for compiler listings. 

Um File Litter# At A Fib Viewer 

► View binary flies such as INI files in 
hexadecimal dump format. 

Get A Screen Capture Utility 

► Capture Presentation Manager Windows 
or the OS/2 Desktop to a file, printer, or 
the system clipboard. 

► Paste images into a word processor and 
create great looking User Manuals. 


(205) 344-0672 

m 


Taylor Made Systems 
Mobile, AL 86618 
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Gbjectview, PC NOMAD, Quicksil¬ 
ver/SQL, R&R Reportwriter, SQL Vi¬ 
sion (for Lotus 1-2-3 and Microsoft 
Excel), SUPERBASE, and VP-Expert, 
Requirements for OS/2 Client: IBM 
PC/AT, PS/2 models 30-286, 50, 60, 
70, 80; and compatibles; 4MB RAM; 
3MB hard drive disk space; and OS/2 
1.0 or higher. Requirements for OS/2 
Server: IBM PC, XT, AT, PS/2 models 
30-386, 50, 60, 70, 80; and compati¬ 
bles; 4MB RAM (entry level configu¬ 
ration); 10MB hard disk space (entry 
level configuration); and OS/2 L0 or 
higher. SQLBase Server supports the 
following networks: NetBIOS com¬ 
patible LANs including, NetWare 386 
& Novell 2.11 or higher, IBM LAN 
Server, 3COM 3+ Open, Banyan 
VINES, and Microsoft LAN Manag¬ 
er. Price: $995-9,995. 

Gupta Corp,, 1060 Marsh Rd., 
Menlo Park, Calif. 94025, (800) 876- 
3267 or (415) 321-9500, fax (415) 321- 
5471 ♦ 


IBM CORPORATION Circle No. 116 

Database Server for OS/2 (DB2/2) 1.0 is a 

32-bit relational database for use in 
either a client/server LAN configu¬ 
ration or as a single-user desktop 
database. As a LAN database server, 
it supports application clients on 
DOS, DOS Windows, and OS/2. 
Functionality includes referential 
integrity, DRDA support, query man¬ 
ager, database administrative tools, 
and an OS/2 command line proces¬ 
sor. Upgrades are available for cur¬ 
rent users of the Database Manager 
on OS/2 Extended Edition 1,3 and 
Extended Services 1.0 migrating to 
OS/2 2.0. 

Price: $425, single user; $2,495, 
server. 

Distributed Database Connection 
Services/2 (DDCS/2) 1.0 provides the 
DRDA communications between 
LAN and enterprise data. LAN client 
applications use the DB2/2 database 
server to read or write host databas¬ 


es, including DB/2MVS, SQL/DS, 
and OS/400's relational database. L |njj 
DB2/2 single-user databases use a piTTf I 
single-user version of the DDCS/2 
gateway. 

Price: $500, single user; $4,680, 
multiple user, 

IBM Corp., 895 Don Mills Rd., 

Don Mills, Ont, Canada, M3C 1W3, 

(416) 448-2637, fax (416) 448-2114. 

IMAGESOFTINC, Circle No. 117 

CommonBase 1.2* is a portable C++ 
application framework for develop* 
ing database applications. It hides the 
intricacies of each database API and 
removes learning or using SQL from 
the developer. Applications devel¬ 
oped using CommonBase are 
portable across databases and oper¬ 
ating systems. Price: $1,000. 

ImageSoft Inc., 2 Haven Ave., Port 
Washington, N.Y. 11050, (800) 245- 
8840 or (516) 767-2233, fax (516) 767- 
9067, e-mail mcdhup!imagelos2. 


DeskMan/2™ 

The Desktop Manager for OS/2® 


Now includes a WPS snapshot facility and VUEMan/2 Tt 

Install, configure, backup, restore, secure, and other¬ 
wise manage Workplace Shell™ objects, locally or 
remotely, all with access controls. 


VUEMan/2 , included with 
DeskMan/2 , provides a 
powerful virtual desktop, 
including security, window 
management, screen 
savers, and more. 


DeskMan/2 is fully CID enabled, and supported by 
LAD/2. 


DevTech 


1 Spring wood Road - Forest Acres. SC 292 
31 790-9230 




for LAN Server 
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You’ll never use your debugger again! 



tprints" 



a native 32-bit OS/2 trace facility 

Debugging 
Remote support 
Execution verification 
Performance monitoring 
and more... for only $99.00 

Once you define traces in your code, you can turn them on and off 
from our PM interface at runtime without recompiling. You can 
use 64 different traces to track thousands of variables and data 

areas. For more information, call one of our developers today. 


(713) 871-1448, Fax (713) 87M449 
Hardy Software Systems, Inc. 

4801 Woodway, Suite 415 W, Houston, Texas 77056 

Visa / Mastercard / Discover accepted. Add $ 5.95 shipping and handling. 
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IMPALA SYSTEMS INC Circle No. 118 

IMPALA DB Advisor 1.0 is a database 
productivity tool that provides infor¬ 
mation, such as in-depth reports, on 
DB2/2 or Extended Services database 
structures and objects. IMPALA DB 
Advisor aids in problem solving, 
analysis and reporting, and applica¬ 
tions development testing. Price: 
Please inquire. IMPALA DB Advisor 
1.0 will ship March 31, 1994. 

Impala Systems Inc., P.O. Box 2210, 
11830 S.W. Kerr Pkwy„ Lake Oswego, 
Oreg. 97035, (503) 452-1953, fax (503) 
452-1179. 

INFERENCE 

CORPORATION Circle NollB 

ART*Enterprise 1.0 for OS/2 is an object- 
oriented client/server development 
tool for building computing applica¬ 
tions. It features point-and-dick gen¬ 
eration of GUI, database mapping and 
application objects, multimedia, mul¬ 
tideveloper support, case based 
retrieval (CBR) of unstructured infor¬ 
mation, and rules. ART*Enterprise 
allows creation of applications that 
link multiple heterogeneous databases 
and are portable across OS/2, Macin¬ 
tosh, Windows, Windows NT, UNIX, 
and MVS. Price: $6,995. Beta on OS/2 
available now. General availability: 
March 15,1994. 

Inference Corp., 550 N. Continen¬ 
tal Blvd., El Segundo, Calif. 90245, 
(800) 322-9923 or (310) 322-0200, fax 
(310) 322-3242. 

INFORMATION BUILDERS Circle No. 120 
PM/FOCUS 1.S includes a graphical 
toolset with File Painter, Forms 
Painter, and Query Painter for build¬ 
ing applications. Application compo¬ 
nents are transformed into graphic 
objects that can be moved, manipulat¬ 
ed, and activated with a point, dick, 
and drag of the mouse. PM/FOCUS 
Query Painter transforms database 
fields, record selections, and report 
headings and footers into selectable 
objects. PM/FQCUS becomes LAN- 
ready with the purchase of 
FOCUS/Database Server available in 
8, 16, 32, and larger user configura¬ 


tions. It comes with its own database 
engine and allows the user to port 
existing FOCUS databases, create 
new ones, or use optional interfaces 
to create GUI applications for DB2/2 
and many other SQL databases. The 
price is $798. 

Information Builders, 1250 Broad¬ 
way, New York, N.Y. 10001, (800) 969- 
INFO (4636) or (212) 736-4433, fax 
(212) 695-3247. 

INNOVATIVE DATA 

CONCEPTS Circle No. 121 

TFILE for OS/2 2.12 provides routines for 
manipulating database files including 
reading, writing, and creating data¬ 
base files; inserting and removing 
records; and indexing by one key or 
multiple keys. It is an indexed file- 
access system that is dBase III/III+ 
compatible. In addition, it can also 
maintain DBF, DBT, and NDX files, as 
well as Clipper-compatible indexes. 
TFILE uses dBase III file formats for 
data, index, and memo files, and has a 
pair of routines to translate database 
records from dBase HI format to a for¬ 
mat usable by TCXL's Data Entry Sys¬ 
tem, and back again. A tool is provid¬ 
ed to generate source code for data 
structures. Price: $59. 

Innovative Data Concepts, 122 
North York Rd., Suite 5, Hatboro, Pa. 
19040, (800) 926-4551 or (215) 443- 
9705, fax (215) 443-9753. 

INTEGRATED INF0NET 
TECHNOLOGY UNIT) Circle No. 122 

BusinessLink (BL) 10 is an object-orient¬ 
ed, 32-bit application and information 
system (IS) management software 
package that runs on OS/2 2.1 and uti¬ 
lizes OS/2 Presentation Manager (PM), 
DB2/2 Database Manager, Communi¬ 
cation Manager, and the OS/2 LAN 
configuration for both single user and 
multiuser environments. It allows the 
user to create tables and add field 
names and values. It can be uploaded, 
integrated and worked within the exist¬ 
ing database system. BusinessLink con¬ 
sists of the InIT supplied databases and 
the user-defined ''customized inter¬ 
face" to the RDBMS that is used to 


store data, information query and 
retrieval. The following modules are 
available: Request for Quotation, Bid 
Evaluation, Vendor Selection for 
award, Proposal Preparation, Distrib¬ 
utor Pricing comparison and Vendor 
Prices determination. Proposal Analy¬ 
ses, Purchase Order issuing, Invoic¬ 
ing and Product & Service Tracking. 
BusinessLink offers a standalone ver¬ 
sion, distributed Client/Server sys¬ 
tem, and an OS/2 LAN Server with 
DOS/Windows client and OS/2 
client accessibility, C++ Programming 
approach; application design data¬ 
base management system; GUI imple¬ 
mentation. Price: $799. 

Integrated InfoNet Technology, 25 
Mauchly, Suite 320, Irvine, Calif. 92718, 
(714) 753-7868, fax (714) 753-7877 or 
(714) 753-1777. 

INTELLIGENT 

ENVIRONMENTS Circle No. 123 

AM (Applications Manager) 4.0 is a tool 
for deploying workstation-based 
client/server applications that access 
data on LANs and remote systems. It 
exploits OS/2 for 32-bit, multitasking, 
multi windowed applications with 
interprocess communication and data- 
sharing. Development can be divided 
among programmers using reusable 
components accessed from shared 
libraries. AM allows development of 
applications with object-oriented 
GUIs and ensures well-structured and 
documented code that can be easily 
maintained and modified. It provides 
integration with the DB/2 family, 
SQL/400, SQL/DS, SQL Server, 
Supra, and ORACLE. AM also sup¬ 
ports MicroDecisionware DB Gateway 
and TechGnosis SequeLink for access 
to many other SQL databases. Price: 
$8,400 (includes one year telephone 
support and upgrades). 

SQL/Workbench 2.1 is a development 
tool for designing, compiling, and 
testing static SQL transactions in an 
SAA environment. SQL/Workbench 
produces static SQL packages for IBM 
databases; it supports DB2, DB2/6000, 
SQL/400, SQL/DS, DB2/2, and Data¬ 
base Manager. It provides a language- 
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independent repository that enables 
users of multiple fourth- and third- 
generation languages to implement 
static SQL statements and maintain 
them separate from applications. 
Price: $8,400 (includes one year tele¬ 
phone support and upgrades)* 

AM Interface for CICS OS/21 combines 
the application manager (AM) develop¬ 
ment environment with the robust per¬ 
formance and security of CICS. It 
enables AM-developed applications to 
access remote data and run transac¬ 
tions, using CICS OS/2 2*0, from a vari¬ 
ety of back-ended CICS systems. Price: 
$3,000 (Includes one year telephone 
support and upgrades)* 

Intelligent Environments, Two 
Highwood Dr., Tewksbury, Mass. 
01876, (800) 669-2797 or (508) 640- 
1080, fax (508) 640-1090. 

INTERSOLVINC. Circle No. 124 

Excelerator ft OS/2, an analysis and 
design too) for desktop development. 


incorporates object-oriented technolo¬ 
gy and exploits the multitasking and 
graphical capabilities of OS/2 and 
IBM's Presentation Manager. A SQL- 
based LAN Repository offers multi¬ 
user support. XL-OS/2 users can 
implement data-driven, process-dri¬ 
ven, and event-driven design method¬ 
ologies off-the-shelf, or tailor them to 
local needs with the Customizer. An 
expert system ensures user input con¬ 
forms to the implemented methodolo¬ 
gy. For use with 386, 486, IBM PS/2 
or compatible, OS/2 1.3 or 2.0. Price: 
contact vendor. 

Intersolv Inc, 1700 N.W. 167th PL, 
Beaverton, Oreg. 97006 (800) 547-4000, 
fax (503) 645-4576. 

M. BRYCE & 

ASSOCIATES INC CirdeNo. 125 

"Pride” information Factory 11.Q f an inte¬ 
grated approach to information 
resource management (IRM), includes 
methodologies for enterprise engi¬ 


neering, information systems engi¬ 
neering, and database engineering; an 
embedded repository to inventory 
and reuse information resources; and 
a Project Management system. Its 
architecture provides the user with 
the ability to interface with a variety 
of application development aids (for 
example, CASE). "Pride" Information 
Factory is SAA/CUA compliant and 
translatable. In addition, it uses the 
Double Byte Character Set (DECS). 
Price: begins at $25,000. 

M.Bryce & Associates Inc, 777 Aider- 
man Rd., Palm Flarbor, Fla. 34683, (813) 
7864567, fax (813) 7864765. 



MfCRORIM INC. Circle No. 126 

R.BASE 4.5, a 32-bit relational database 
management system, utilizes the flat 
memory model to enhance speed and 
allows multitasking to enable multi¬ 
ple sessions to operate concurrently. 
Other features include: 4GL with 
embedded ANSI 89 Level 2 SQL, 


MEGA POWER FOR OS/2 BACKGROUND APPS 

► Set the priority OS/2 Apps in Full Screen or Window mode including Apps installed as icons. Get 
information to help prioritize DOS Apps. 

► BIG performance gains in heavy multitasking and/or memory overcommit scenarios or as little as 
two background Apps via prioritization. 

► Indepth Online Help with Tips, Questions and Answers NEVER BEFORE PUBLISHED Find out 
how faster machines just “spin” faster and mixing DOS and OS/2 is a disaster. 

► The most powerful Application ever designed for OS/2. It is more effective than multiple 
processors for Background Apps. 

► We are the steering wheel and gas pedal for OS/2. If you don’t have our products— 

YOU’RE OUT OF CONTROL! 

► “READY FOR OS/2”. 

► 32 bit Presentation Manager Application (works on OS/2 2.0 & 2.1). 90-Day money 
back guarantee! Absolutely required for ALL OS/2 systems. NEW LOWER PRICES. 

► Background Master I/II—32/64 priority levels. $ 19/S29 

► Priority Master L/1I—-96/128 priority levels. $39/$49 

ScheduPerformance Inc. 

3474 N. University Dr. * Suite 217 • Sunrise, Florida 33351 

Voice (305) 486-8299, Fax (305) 486-5018 • M-F 10:00AM to 8:00PM EST 
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interactive debugger, full text index¬ 
ing, multicolumn indexing, primary 
and foreign key support, forms within 
forms, watkable menus, row-level 
locking, row and table level entry/exit 
procedures. Price: $795. 

Microrim Inc,, 15395 S.E. 30th PL, 
Bellevue, Wash. 98007, (800) 628-6990 
or (206) 649-9500, fax (206) 746-9438, 
CompuServe go microrirp. 

N SYSTEMS Circle No. 127 

DBAPort 10 automates the conversion, 
duplication, arid nfvi&rafUm of DDL 
schema, data, ‘'indexes, views, and 
privileges between multiple RDBMSs 
including SYBASE/SQL Server for 
MVS, Oracle, DB2/2, Ingres, SQLBase, 
Informix, XDB, Ingres, Rdb, HP-ALL- 
BASE, and ODBC. It includes 
portable character interface and MS- 


Windows GUI interface and allows 
porting of all or subsets of source 
databases tables, columns, and data. 
Also, it maps data to default data 
types in target database that can be 
modified. DBAPort also automates 
several database administration and 
development tasks. Price: $3,495 plus 
$795 for each database target/source. 

N Systems, 2300 103rd Ave., N.E., 
#A, Bellevue, Wash. 98004, (206) 450- 
0815, fax (206) 827-8113. 

ONTOS INC, Circle No. 128 

ONTOS DB 3. 0, a distributed object 
database management system, pro¬ 
vides capability for developing and 
deploying an expanded range of 
strategic applications. It is an archi¬ 
tecture based on objects, supports 
workgroup applications, and pro¬ 
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vides a range of performance tuning 
controls. The ONTOS DB architecture 
includes an object model, an active 
data dictionary, a programmatic data 
dictionary interface, and class-based 
storage management. It is written in 
object-oriented C++. It is priced at 
$5,500. 

Ontos Inc., Three Burlington 
Woods, Burlington, Mass. 01803, (617) 
272-7110, fax (617) 272-8101, e-mail 
stone@ontos.com. 

OPENBOOKS 

SOFTWARE INC, Circle No. I2B 

OpenBooks 1,52 is a client/server data¬ 
base access and query system. It 
enables users to access, query, ana¬ 
lyze, and report on data from multi¬ 
ple database servers. Open Books 
transforms request for business infor¬ 
mation into SQL and back again. 
With a dick of the mouse, users see 
raw data transformed into business 
information. OpenBooks includes a 
query manager to meter data from 
the server, and dynamic forms with 
automatic drill down. OpenBooks 
runs on SQL Server, DB2, Oracle, 
Sybase, and other databases. Price: 
$995. 

OpenBooks Software Inc., 95 Hay¬ 
den Ave., Lexington, Mass. 02173, 
(617) 860-8300, fax (617) 860-8399. 

ORACLE Circle No. 130 

Oracle? for OS/2 is a relational data¬ 
base management system (RDBMS) 
that runs identically on over 80 dis¬ 
tinct hardware and operating system 
platforms. As a 32-bit application, it 
utilizes the features of OS/2 2,x. Ora¬ 
cle/ for OS/2 comes in a standalone 
database; a NetWare edition server 
which includes Oracle's SQL + Net SPX 
drivers; and a LAN Server edition 
which includes Oracle's SQL*N Net¬ 
BIOS drivers. Additional wide area 
network connectivity is provided 
through Oracle's 3QL*Net TCP/IP, 
SQL*Net APPC for OS/2 servers. The 
SQL*Net software allows the Oracle? 
Server for OS/2 to access distributed 
data from a variety of other Oracle 
platforms including DEC VAX, IBM 
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Now you can access 
the most comprehensive, 
detailed listings of vendors 
and applications serving 
the OS/2 market — all from 
one source: the IBM OS/2 
AND LAN SERVER APPLI¬ 
CATION DIRECTORY. 

This is the complete guide to solu¬ 
tions tor even the most special¬ 
ized applications. It keeps devel¬ 
opers up to date on the competi¬ 
tion and end-users up to speed on 
what’s available and where to 
find it. 

The 300-page directory gives you 
fully detailed listings that include: 

• Company name 

• Contact name 

• Address 

• Phone number 

• Product description 

• Details on software features 

• Price 

• Availability date 


Coming in December from the publishers of 

OS/2 Devetoper/Software QevelopmentZLAN Magazine/DBMS/ 

Database Programming & Design/Dr. Dobb's Joumal/UNtX Review a nd IBM C orp.! 

Your search for 

OS/2 solutions 
just got easier. 

[ j j J J 
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Applioatioi i Solution? 
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Applications are conveniently 
organized by 17 general industry 
categories in alphabetical order; 

* Accounting/personat finance 

* Business-specific 

* CAD/CAOAM 

* Communications 


ONLY $9.95 


When off'press in December 1993, send me_copies of the IBM OS/2 AND 

LAN SERVER APPLICATION DIRECTORY for only US$9'95 each, plus US$3.50 
shipping/handling. Add US$2 for shipping to Canada and overseas. 

□ Payment enclosed 

(include sales tan in CA, GA, IL NY, St TX; GST in Canada) 

□ Charge my; □ Visa □ MasterCard □ American Express 

Card# _ Exp, date 


Name 

Title 


Company 


Address 
City/State/Frov. 
Zip/Postal Code 
Phone 


Country 


FAX 


Signature (REQUIRED) 


MAIL TO: Daniel Strickland, OS/2 and LAN Server Application Directory, 
Directory Dept., Miller Freeman Inc., 600 Harrison Street San Francisco, CA 
94107 USA FAX TO: (415) 905-2239 OR CALL: (415) 905-2728 


* Database 

* Desktop publishing 

* Development tools 

* Device driver 

* Electronic mail 

* Game s/entertainment 

* Graphics 

* Information management 

* Integrated workgroup 

* Networks 

* Spreadsheets 

* Utilities 

* Word processing 

ftlud you yet: 

* Index of vendors, cross-refer¬ 
enced by product name 

* Special separate section of 
applications certified by IBM’s 
Ready! for LAN Server certifi¬ 
cation program 

Make your solutions- 
search easy. 

Send for the IBM OS/2 AND LAN 
SERVER APPLICATION DIRECTORY. 

OS/2 is a registered trademark of IBM Carp, 
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mainframes, UNIX machines, and 
NetWare fileservers. Oracle/ for 
OS/2 includes new data loading facil¬ 
ities as well as National Language 
support. Also, available separately 
are Oracle's precompilers {Pro*C, 
Pro*COBOL, and Pro ^Fortran) which 
can be used to develop OS/2, Win¬ 
dows, or DOS client application. 
Price: Oracle/ Database for OS/2 is 
$699; call for pricing information for 
Oracle/ Server. 

Oracle Corporation, 400 Oracle 
Pkwy., Redwood Shore, Calif, 94065, 
{415} 506-5888, fax (415) 506-/206. 

PROTOVIEW DEVELOPMENT 
CORPORATION Circle No. 131 

SQLView t.O Visual Database Access 

provides live data manipulation of 
over 30 different database sources 
through the ProtoGen+ Workbench— 
including a database that writes to 
ODBC or Q+E Library (Q+E data dri¬ 
vers included). This product requires 
ProtoGen+. Price: $395. 

ProtoView Development Corpora¬ 
tion, 353 Georges Rd., Dayton, N.J. 
08810, (800) 231-8588 or (908) 329- 
8588, fax (908) 329-8624, CompuServe 
75300,3510. 

Q+E SOFTWARE Circle No. 132 

Q+E Database Editor 5M, an intuitive ad 
hoc query and reporting tool, gener¬ 
ates reports with breaks and subto¬ 
tals, accesses databases identically, 
builds queries, designs query by 
example forms, links data into other 
applications, and has a customizable 
Icon Bar, Requirements: IMB PS/2, 
PC/AT or compatible, 2MB RAM, 
4MB Hard Disk space. Price: $299. 

Q+E Database Library 2.0 tor OS/2 
provides a tool for building ODBC- 
enabled applications. It provides 
SQL and PC DBMS client access using 
ODBC for OS/2. It also provides 
functions for transaction processing, 
data dictionary, stored procedures, 
parameter for creating multipurpose 
SQL queries, SQL statements and 
parameterized queries, data conver¬ 
sion, and column binding. Q+E Data¬ 
base Library 2.0 for OS/2 includes the 


Q+E Query Builder to provide users 
with a way to build SQL statements 
and ODBC-compliant Q+E Drivers. 
Q+E Database Library 2.0 for OS/2 
and the supplied Q+E Drivers are 32 
bit Price: $699. The Q+E Database 
Library 2,0 will ship on January 31, 
1994. 

Q+E Software, 5540 Centerview 
Dr., Suite 324, Raleigh, N.C. 2/606, 
(800) 876-3101 or (919) 859-2220, fax 
(919) 859-9334, CompuServe 

71333,125, 

SAS INSTITUTE INC . Circle No. 133 

The SAS System 6.0 provides tools to 
access, manage, analyze, and present 
data within an applications develop¬ 
ment environment. Capabilities 
include EI5, spreadsheets, graphics, 
data analysis, report writing, quality 
improvement, project management, 
computer performance evaluation, 
client/server computing, database 
access, decision support, and applica¬ 
tions development. The software pro¬ 
vides an object-oriented development 
environment and offers a code-free 
development environment that con¬ 
solidates the SAS System's capabili¬ 
ties for data access, management, 
analysis, and presentation. The soft¬ 
ware includes procedures for control¬ 
ling the users path through an appli¬ 
cation and transporting screens 
between operating environments. 
Price: licensing fee schedule for Base 
SAS on one PC is $940 for the first 
year, $430 for renewal. Call for full 
license fee schedule. 

SAS Institute Inc., SAS Campus 
Dr., Cary, N.C. 27513, (919) 6/7-8000, 
fax (919) 677-8123. 

S-CUBEDINC. Circle No. 134 

AnyClient TO Programmable Middleware 

enables the user to update multiple 
databases from queries displayed on 
spreadsheets, project managers, word 
processors, visual development envi¬ 
ronments, or tools users have chosen 
to display their queries. AnyClient 
permits clients to query and update 
multiple tables simultaneously. It 
traps illegal multiple updates and 


violations of database rules, trans¬ 
forms them into valid updates, and 
processes the data. Users are insulat¬ 
ed from the complexities; a DBA sets 
up the rules that create a virtual data¬ 
base and AnyClient does the rest, 
permitting download and upload of 
data to or from a client environment 
(Excel, Lotus, Access, and so on). 
Clients that previously could launch 
only SQL commands now can take 
advantage of RPC features and func¬ 
tions of the underlying communica¬ 
tion medium and RDBMS, Call for 
pricing information, 

DB Manager C/S Plus 10 provides 
developers of DB2/2 and DB6000 
based systems with an ODBC compli¬ 
ant driver that takes advantage of 
DARI/DRDA and optionally pro¬ 
vides them with a transaction orient¬ 
ed fourth generation language. DB 
Manager C/S Plus enhances the func¬ 
tionality of DB2/2 and DB6000 by 
providing them with stored proce¬ 
dure and trigger policy functions. It 
also provides client side ODBC com¬ 
pliance with stored procedure exten¬ 
sions. Price :$795-developer, $195- 
server engine, DB Manager C/S Plus 
will be ship on March 15,1994. 

S-Cubed Inc., 1010 Washington 
Blvd., Stamford, Conn. 06901, (203) 
323-0760, fax (203) 323-2007. 

SEQU1TER 

SOFTWARE INC. Circle No. 135 

CodeBase 5.0 and CodeBase++ 5.0 are 

DBMS source code libraries that per¬ 
mit database management with 
multiuser dBASE, FoxPro or Clipper 
file compatibility from C, C++, Pas¬ 
cal, or Basic. They have bit optimiza¬ 
tion query technology that analyzes 
queries using Index information, so a 
record is only retrieved from disk 
when it belongs in a query solution 
set. The user can utilize CodeReporter 
to design reports interactively and 
then generate corresponding source 
code. CodeBase and CodeBase++ 
allow porting between DOS, Win¬ 
dows, OS/2, Macintosh, and UNIX. 
Price: $495, $1090 multi platform ver¬ 
sion for UNIX and Macintosh. 
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CodeTransiator 2.1 automatically 
translates dBASE III PLUS and Clip¬ 
per Summer '87 applications into C. 
It allows the user to quicken a slow 
application by converting it to C and 
using it with CodeBase. Applications 
look and act like the original pro¬ 
grams. Use CodeTransiator to convert 
existing applications or to help learn 
C and CodeBase. Price: $245. 

Sequiter Software Inc., P.O. Box 
575, Newmarket, N.H., 03857-0575, 
(403) 437-2410, fax (403) 436-2999. 

SYBASE INC. Circle No. 136 

Sybase SQL Server 10.0 is a relational 
database server based on multi¬ 
threaded database operating system 
architecture. It features scalable, serv¬ 
er-enforced integrity, application 
availability, and on-line distributed 
RDBMS capabilities. It provides the 
user with connectivity to link any ter¬ 
minal, personal computer, or work¬ 
station with a server. SQL Server 
technology controls and supports 
open, standards-based connectivity. 
Price: $3,750-158,040. 

OmniSQL Gateway gives users trans¬ 
parent access to corporate data 
regardless of where or in what kind 
of database the information resides. 
Non-SYBASE data can now look and 
feel like SYBASE data, and the user 
can work with it using the industry¬ 
leading functionality of the SYBASE 
SQL Server. QmniSQL Gateway can 
be used for customized applications, 
data migration, and ad hoc decision 
support. OmniSQL Gateway consists 
of two components: (1) an OmniSQL 
server available for OS/2, major 
UNIX platforms, VAX VMS, and 
Novell NetWare; and (2) OmniSQL 
Access Modules that exist on the plat¬ 
form of the target source. OmniSQL 
Access modules currently exist for 
ORACLE, SYBASE, DB2, RMS, ISAM, 
and other enterprise-wide databases. 
Pricer $2,250-83,000 for OmniSQL 
Server. $2,250-102,730 for OmniSQL 
Access Modules. 

SYBASE Open Server 2.0 develop¬ 
ment toolkit allows developers to 
build server applications that appear 


to Sybase Open Client users as 
though they were a multithreaded 
SYBASE SQL Server. Organizations 
can extend the data access capabilities 
of their Sybase Open Client and DB- 
Library-based client applications 
beyond Sybase SQL Server data to the 
data made available through Sybase 
Open Server applications regardless 
of the data type, source, or location. 
A data source that is accessible to the 
application programmer (robotics, 
telephone switching systems, process 
control sensors, stock quote feeds, 
room monitoring devices, and so on) 
can be accessed using Open Server. 
Open Server also shields server appli¬ 
cations from the communications pro¬ 
tocols of the network on which they 
are operating. Using the Open Server 
toolkit, programmers create applica¬ 
tions that run on many different trans¬ 
ports. SYBASE Open Server for CICS 
provides users on a network with 
access to IBM mainframe data and ser¬ 
vices. This includes MVS data, appli¬ 
cations, and mainframe services run¬ 
ning under the control of IBM's CICS 
transaction processing monitor. It 
extends the huge investments in main¬ 
frame applications that access VASM, 
DL/I, DB2, and third party DBMSs by 
making them available as servers for 
SYBASE client applications. Price: 
$445-24,950 for PC DOS or OS/2. 

SYBASE Open Client 4.6 is an appli¬ 
cation toolkit that provides program¬ 
mers with the services to develop 
applications that access diverse data 
sources. Its run-time services free 
developers from dealing with a vari¬ 
ety of application protocols and net¬ 
working issues. It supports multiple 
application programming interfaces 
(APIs) such as Sybase Embedded 
SQL, SYBASE DB-Library and the 
Microsoft ODBC (Open Database 
Connectivity). This allows applica¬ 
tions that utilize Open Client to 
read/write access to Sybase SQL 
Server data as well as non-Sybase 
data via the Sybase OmniSQL Gate¬ 
way or through Sybase Open Server. 
Open Client also supports a number 
of transport protocols via Open 


Client's Net Library. Price: $470- 
17,280 list price. 

Sybase Inc., 6475 Christie Ave., 
Emeryville, Calif, 94608, (800) 

8SYBASE or (510) 596-3500, fax (510) 
658-9441. 



VERSANT OBJECT TECHNOLOGY 
CORPORA TION Circle No. 137 

VERSANT ODBMS 2.3 is a ODBMS 
designed to support multiuser, pro¬ 
duction applications in the distrib¬ 
uted environment. VERSANT is built 
within a scalable distributed architec¬ 
ture that provides features such as 
transparent data distribution, object- 
level locking, dynamic schema evolu¬ 
tion, and built-in workgroup comput¬ 
ing support. Price: $6,000 and up. 

Versant Object Technology Corp., 
1380 Willow Rd., Menlo Park, Calif. 
94025, (800) VERSANT (837-7268) or 
(415) 329-7500, fax (415) 325-2380. 

XDB SYSTEMS INC. Circle No. 138 

XDB QMT3.0 is an IBM query manage¬ 
ment facility (QMF) compatible, PC 
and workstation-based data query 
and reporting facility designed to 
operate with mainframe DB2 or local 
database engines. XDB-QMT can be 
used as an off-line tool for report 
development, testing, and training, 
or as an on-line tool with XDB-Link 
for real-time production queries and 
reports. Using XDB-QMT strictly as 
an off-line tool, the user can down¬ 
load a representative sample of a 
mainframe database to the DB2 com¬ 
patible XDB-Server on a LAN or to 
an individual PC. Report objects, 
such as queries, report forms, and 
procedures, created with XCB-QMT 
can be executed on the PC or export¬ 
ed to QMF on the mainframe, with¬ 
out modification, for production 
against DB2 data. XDB-QMT can be 
used as a real-time, on line tool when 
it is configured with XDB-Link, 
When using XCB-Link, XDB-QMT 
users can access mainframe DB2 data 
directly from a PC in a stand-alone 
environment or LAN configuration. 
Price: $1,200. Version 3.3 will be ship¬ 
ping First Quarter, 1994. 
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XDB's SQL 3.0 engine provides refer¬ 
ential integrity, disturrency control, 
and system catalogue. XDB-SQL C SDK 
comes complete with a C precompiler 
and a C-API. C programmers can 
embed SQL into a program or call SQL 
engine functions using a C function call 
library. Application written using XDB- 
SQL C SDK can be used either in a 
stand-alone environment against a resi¬ 
dent SQL engine, as a client worksta¬ 
tion accessing any XDB-Server on a 
LAN, or connected to mainframe DB2 
via XDB-Link. Price: $650. Version 33 
will be shipping First Quarter, 1994, 
XDB Server 32 is a 32-bit, multiuser 
database system that features referen¬ 
tial integrity, distributed database 
access, transaction processing, backup 
and recovery, authorization, concurren¬ 
cy control, and system catalogue tables. 
New features with the 33 version 
(available First Quarter, 1994) include 
compatibility with DB2 33, query opti¬ 
mization enhancements in read-only 
isolation levels, a governor that allows 
the user to limit the number of record 
retrieved, and server-to-server commu¬ 
nications. Clients running under Win¬ 
dows NT, Windows, OS/2 , and DOS 
provide user interfaces that gather 
input and prepare requests foT the 
XDB-Server. The XDB-Server provides 


storage, access, and control of data. 
Because the XDB-Server is network- 
independent, DB2 compatibility can 
exist on multiple platforms including 
Windows NT and OS/2. Any of XDB's 
development, fourth generation lan¬ 
guage, and reporting tools, as well as 
third party tools including Power¬ 
Builder, can act as clients to the XDB- 
Server. Price: $2,495 (1-5 users; $100 
each additional users). Version 33 will 
be shipping First Quarter 1994. 

XDB-Link 32 contains a set of inter¬ 
face software that links SQL applica¬ 
tions on PCs, LANs, and workstations 
to DB2 data residing on the mainframe. 
XDB-Link consists of two components: 
XDB-Link DRDA Gateway, which 
resides on the PC, and XDB-Link host- 
based C1CS program, which resides on 
the mainframe. These components 
communicate via LU 6.2 protocols to 
satisfy DB2 SQL requests made from 
PCs, LANs, and workstations. XDB- 
Link is based on a client/server archi¬ 
tecture. It supports DOS, OS/2, and 
Windows clients. In a development 
environment, XDB-Link extends sys¬ 
tems level testing to the PC environ* 
ment by providing access to mainframe 
production data. In a production envi¬ 
ronment, XDBs application tools and 
LAN applications can now access DB2 


data residing on the mainframe. XDB- 
Link provides access to IBM's relational 
databases, including DB2, DB2/VM, 
and 5QL/400 via DRDA. In addition, 
XDB-Link provides access to non-rela¬ 
tional databases via Remote Procedure 
CaUs (RPCs). Price: $8,500 (1-10 users). 
Version 3.3 will be shipping First Quar¬ 
ter 1994. 

XDB-Workbench 3.0 is a DB2-compat- 
ible development and environment for 
PCs, LANs, and workstations. The 
product consists of a powerful SQL 
database engine, a COBOL precompil¬ 
er, and a suite of development and 
administrator utilities. The COBOL 
precompiler follows SAA standards. 
The XDB-Workbench enables the user 
to develop, test, and run COBOL pro¬ 
grams with embedded SQL on PCs, 
LANs, and workstations. The user 
migrates the programs to the main¬ 
frame. No source modification is 
required. The XDB-Workbench can be 
used stand-alone, as a client accessing 
any XDB-Server on a LAN, or connect¬ 
ed to mainframe DB2 via XDB-Link. 
Price: $1,495. Version 33 will be ship¬ 
ping First Quarter, 1994. 

XDB Systems Inc., 14700 Sweitzer 
Ln., Laurel, Md. 20707, (800) 488-4948 
or (301) 317-6800, fax (301) 317-7701, 
email xdb@xdb.com. 


94 


OS/2 DEVELOPER 



New Tools and Utilities 


Product 

Watch 


TOOLS 

AM/Harvest. AM/Harvest delivers 
capabilities for building client/server 
applications and managing the sharing, reuse, and 
maintenance of application code* AM/Harvest 
simplifies project management: code is shared, 
reused, and maintained within the development 
teams* It addresses the complexities of managing 
change during iterative client/server development 
processes* AM/Harvest runs on OS/2 2.0 or later 
and works with Intelligent Environment's AM 3 
or higher* It costs $5,500.00 per server, including 
one year of free technical support and upgrades* 

Intelligent Environments 

Phone: (508) 640-1080, Fax: (508) 640-1090 

Device Driver Source Kit for OS/2 * A CD-ROM of 
OS/2 device driver source code, IBM's Device Dri¬ 
ver Source Kit enables hardware vendors to create 
their own OS/2 device drivers* The kit contains 
source code for over 79 device drivers and tools, 
along with on-line reference books that include 
information on OS/2 device drivers and device 
driver function, and hints and techniques for 
device driver construction* It supports various 
device types, including display, printer, CD-ROM, 
direct access storage device, small computer sys¬ 
tem interface, disk, mouse, keyboard, multimedia, 
pen, touch, serial, and parallel* Device Driver 
Source Kit is priced at $499*00. 



menting essential information while writing code. 
Features include paragraph styles, two-level 
indexes, hypertext links, fonts, color, embedded 
graphics, text emphasis, interface to PM program¬ 
ming and Gpf, assistance through Lotus Ami Pro 
macros, and various output formats. 

SE International Inc* 

Phone: (800) 473-4685 or (407) 241-3428 

Galaxy Application Environment 2.0, Galaxy Appli¬ 
cation Environment 2.0 is a cross-platform devel¬ 
opment environment for creating applications 
that are graphical and distributed. Galaxy 
Release 2*0, available in C and C++ versions, 
adds new features, and establishes a consistent 
set of application development capabilities 
across supported platforms. 

Visix Software Inc. 

Phone: (800) 832-8668 or (703) 758-8230, 

Fax: (703) 758-0233 

GammaTech Utilities for OS/2, Release 2.1 of Gam- 
maTech Utilities' OS/2 workstation software pro¬ 
vides the ability to perform volume recovery, opti¬ 
mization, and maintenance operations without 
extensive technical knowledge. The utilities sup¬ 
port high performance file system and file alloca¬ 
tion table formats. Many of the features operate in 
both the Presentation Manager and Command 
Line modes. 


IBM Corp. 

Phone: (800) 633-8266 


SofTouch Systems Inc. 
Phone: (405) 947-8080 


DocuMento 1.1 . A 32-bit development tool that 
works with OS/2 2*0 and 2*1, DocuMento allows 
developers to create on-line documentation and 
help screens without GML skills* Using DocuMen¬ 
to, developers work in a parallel fashion, docu- 


tPF Editor for OS/2 2.x. A 32-bit PM IFF development 
editor, IFF Editor provides tools for creating on¬ 
line help and on-line documents for OS/2 2*x. 
Designed to be easy to use for both programmers 
and non-programmers, it provides a method for 
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adding help to applications or converting existing 
documents into on-line documents. To take advan¬ 
tage of all IPF Editor functions, it must be used 
with IBM OS/2 Toolkit 2.x's IPF Compiler. IPF 
Editor is available for $95.00. 

Perez Computing Services 
Phone: (206) 428-5025 

Pen for OS/2. A pen computing system that adds 
pen capabilities to OS/2, DOS or DOS/Windows 
applications, Pen for OS/2 is designed for mobile 
computing desktops and for collaborative com¬ 
puting on the desktop. Capabilities include hand¬ 
writing recognition, a window that adds hand¬ 
writing recognition to non-pen-aware applica¬ 
tions, standard and user-customizable gestures, 
and a pop-up keyboard. Included in the package 
are Teiepen, a collaborative computing system, 
and Sketchpad, a freehand drawing tool. Pen for 
OS/2 requires a computer running OS/2 2.1, a 
pen sensor (digitizer) integrated with a display 
or digitizing tablet, 2MB RAM over the require¬ 
ments of OS/2 2.1, and SMB of hard disk space. 
The single unit price is $89.00. 

IBM Corp. 

Phone:(800)342-6672 

System Architect 3.0. A new version of System 
Architect, a CASE tool for developers building 
client/server applications, offers network securi¬ 
ty, access control, enhanced data modeling, 
1DEF0 and IDEFIX support, a graphical user 
interface, object-oriented features, color, real-time 
modeling, and a browser. The OS/2 PM 2.1 ver¬ 
sion costs $1,795.00 for the single user (merge) 
version and $3,790 for the first two copies of the 
network version. 

Popkin Software k Systems Inc. 

Phone: (800) 732-5227, Fax: (212) 571-3436 

Team/V 1Z An extension to the Smalltalk/V object- 
oriented environment, Team/V allows development 
teams to organize, structure, and coordinate their 
work. Because the releases for Win32 and OS/2 have 
the same interface, programmers using Team/V on 
OS/2 and Windows 3.1 or Windows NT can share 
common repositories and develop packages that 


may be used in either environment. Team/V pro¬ 
vides tools to define, store, browse, and share pack¬ 
ages, which are modules that define a program func¬ 
tion or element. Packages contain source code for 
Small talk/V definitions; they also can contain 
descriptive information such as comments, author 
name, and version number. Team/V is priced at 
$1,595.00. Registered Smalltalk/V users can buy 
Team/V at a special price for a limited time, 

Digitalk Inc. 

Phone: (714) 513-3000, Fax: (714) 513-3100 

UTILITIES 


Advanced Task Scheduler for OS/2. A 

job scheduler utility. Advanced Task 
Scheduler (ATS) is designed to allow developers 
to build job streams, giving them complete con¬ 
trol of how and when to run each program. ATS 
lets developers set the time, day, and month a 
job should run, among other features. 
It allows developers to define an unlimited 
number of tasks, dependencies, and holidays, 
and logs all activity on disk. ATS for OS/2 
requires OS/2 2.0 or later. It costs $249.00; quan¬ 
tity discounts and site licenses are available, 

MFfR Software and Consulting 
Phone: (908) 821-0359 


OS/2 CALENDAR 


March 15-17 

April 19-21 

May 2-6 
July 19-22 


Software Development, 
San Jose, Calif. 

(800) 441-8826 

OS/2 Technical 
Interchange, 

San Francisco 
(407) 982-9353 

PEN EXPO, Boston 
(508) 649-4200 

OS/2 World, 

Santa Clara, Calif. 
(415) 905-2354 
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Discover why FoxPro, Clipper, 
and dBASE were all written in C. 


#here is a good reason why 
* your database language was 
developed in C. In fact, there 
are many good reasons. 

C code is small. C code is fast. C code is 
portable. C code is flexible. C is the 
language of choice for today's professional 
developer. With the growing complexity of 
database applications, C is a realistic 
alternative. Now with CodeBase 5,0, you 
can have all the functionality, simplicity and 
power of traditional database languages 
together with the benefits of C/C++, 

C speed ■ fast code, true executables... 

FoxPro, Clipper, and dBASE were written 
in C primarily for speed. But those compilers 
don't really compile, they combine imbedded 
language interpreters into your .EXE, Now 
thafs slow. For dazzling performance you 
need the true executables of C, With 
CodeBase you get the real thing, C code. 
Consider the following statistics, from the 
publisher of Clipper: 


slower 



Sieve of Erastothenes 

Benchmark for Prime Number Generation 
Shows C to be incredibly faster ! 


remember, those products are all written in 
C. So why do you need to lug all their extra 
code around? You don't. CodeBase is a 
complete DBMS, in C No fat executables 
stuffed with unused code. No runtime 
modules. No royalties. Just quality C code. 
CodeBase is just what you need, 

C portability-ANSI C/C++ 
on every hardware platform... 

No other language exists on more platforms 
than C/C++. Why rew'rite your entire 
application for DOS, Windows, Windows 
NT, OS/2 or UNIX? With CodeBase the 
complete C source code is included, so you 
can port to any platform with an ANSI C or 
C++ compiler. Now and in the future. 

dBASE Compatible data, index 
and memo files... 

You want the industry standard. You need 
compatibi 1i ty. S u re, d B AS E i s the sta n d ard, 
but every dBASE compatible DBMS 
product uses its own unique index and memo 
file formats. Only CodeBase has them all: 
FoxPro (.cdx), Clipper (,ntx), dBASE IV 
(.mdx) and dBASE III ( ndx), Now 1 it’s your 
choice, we're compatible with you. 


Announcing 
CodeBase 

The power of a complete DBMS, the benefits of C 


ins 

5% 


C size • small executables, 
no added overhead... 

FoxPro, Clipper and dBASE would like you 
to believe you need their entire development 
system to build database applications. But 
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NEW - Multi-user sharing with 
FoxPro, Clipper and dBASE... 

Now your multi-user C/C++ programs can 
share "data, index and memo files at the 
same time as concurrently running FoxPro, 
Clipper and dBASE programs. No 
incompatibilities. No waiting. 


NEW ■ Queries & Relations 
1000 times faster... 

CodeBase 5,0 now lets you query related 


data files with any logical dBASE expression. 
Our new Bit Optimization Technology 
(similar to FoxPro's Rushmore technology) 
uses index files to return a query on a 1/2 
million record data file in just a second. 
Automatically take advantage of this query 
performance by using our new CodeReporter: 



simply draw your report, then include it in any 
program you write. Call 403/437-2410 now for 
your FREE working model of Code Reporter, 

New - Design complex reports 
in just minutes... 

Our new r Code Reporter takes the painstaking 
work out of reports. Now simply design and 
draw r reports interactively under Windows 3.1, 
then print or display them from any DOS, 
Windows or UNIX application, 

SPECIAL - FREE CodeReporter 

Order CodeBase 5 before June 30, 1993 
and receive CodeReporter for free! This 
offer includes our no-risk, 90-day money 
back guarantee, so order texlay! 


5.0 

Thw C/C++ Library tot DataBase Management 

Call Now 
403-437-2410 
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Visual is just the beginning 



Why settle for ordinary visual when new 
Borland C++ gives you so much more? 
The highest quality fourth-generation 
tool set. A fully customizable and open 
desktop. The ability to target 
16- and 32-bit 
Windows simul¬ 
taneously. And, 
of course, it’s 
“visual,” 

Only Borland C++ 
gives you a fully 
integrated profes¬ 
sional editor featuring BRIEF® tech¬ 
nology, powerful Turbo Debugger* GX, 
and integrated C and C++ VBX control 
support. 


An environment to die for 

Borland C++ 4.0 takes the bureaucracy 
out of development. With the visual 
Project Manager and its multi-target 
capabilities, even the most complex 
projects arc handled automatically. 

The flexibility of AppExpert actually 


generates much of your application for 
you. TargetExpert, ClassExpert, Dialog- 
Expert, and Resource Workshop" 
streamline the tasks of setting up and 
customizing your applications. 

A true C++ implementation 
that's years ahead 

Languages evolve for a good reason— 
so programmers can realize ever- 
increasing productivity and safety of 
code. That’s why Borland is the first to 
bring important new enhancements to 
the C++ language, like full support 
for templates, exception handling, 
and Run-time Type Information. And 
Borland C++ includes ObjectWindows™ 
Library (OWL) 2.0—the world’s most 
popular framework, 

Borland C++ is the world-standard 
C++ because it’s the easiest to use, 
yet has power to spare for the most 
complex tasks. If you're serious about 
C++ programming, new Borland C++ 
4.0 is the environment you’ve got to 
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have. After all, if your compiler is only 
visual, it’s just a facade. Get new 
Borland C++ 4.0 for Windows and DOS 


now. 



^90-day, money-back guarantee! 

I See your dealer or call now, I 
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